ObjectDataSource Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un oggetto business che fornisce dati ai controlli associati a dati nelle architetture di applicazioni Web a più livelli.
public ref class ObjectDataSource : System::Web::UI::DataSourceControl[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
inherit DataSourceControlPublic Class ObjectDataSource
Inherits DataSourceControl- Ereditarietà
- Attributi
Esempio
Questa sezione mostra un oggetto ObjectDataSource nel markup in una pagina .aspx e mostra gli oggetti business con cui funziona. L'esempio è la pagina .aspx. Contiene un GridView controllo associato a un ObjectDataSource controllo . Il ObjectDataSource markup del controllo specifica il nome dell'oggetto business e il nome del metodo dell'oggetto business da chiamare per recuperare i dati.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1" />
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.CS.EmployeeLogic" />
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - Visual Basic Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1" />
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.VB.EmployeeLogic" />
</form>
</body>
</html>
Nell'esempio seguente viene illustrato l'oggetto business utilizzato dal ObjectDataSource controllo nella pagina .aspx. Molti altri ObjectDataSource esempi di codice usano anche questo oggetto business. L'esempio è costituito dalle due classi di base seguenti:
La
EmployeeLogicclasse è la classe della logica di business usata dall'oggetto ObjectDataSource .La
NorthwindEmployeeclasse definisce l'oggetto dati restituito dalGetAllEmployeesmetodo dellaEmployeeLogicclasse .
Una classe aggiuntiva NorthwindDataException viene fornita per praticità.
Questo set di classi di esempio funziona con il database Northwind Traders, disponibile con Microsoft SQL Server e Microsoft Access. Per un esempio di lavoro completo, è necessario compilare e usare queste classi con l'esempio di pagina .aspx fornito.
namespace Samples.AspNet.CS {
using System;
using System.Collections;
using System.Collections.Specialized;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
//
// EmployeeLogic is a stateless business object that encapsulates
// the operations one can perform on a NorthwindEmployee object.
//
public class EmployeeLogic {
// Returns a collection of NorthwindEmployee objects.
public static ICollection GetAllEmployees () {
ArrayList al = new ArrayList();
ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];
SqlDataSource sds
= new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");
try {
IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);
// Iterate through the Enumeration and create a
// NorthwindEmployee object for each ID.
foreach (DataRowView row in IDs) {
string id = row["EmployeeID"].ToString();
NorthwindEmployee nwe = new NorthwindEmployee(id);
// Add the NorthwindEmployee object to the collection.
al.Add(nwe);
}
}
finally {
// If anything strange happens, clean up.
sds.Dispose();
}
return al;
}
public static NorthwindEmployee GetEmployee(object anID) {
return new NorthwindEmployee(anID);
}
public static void UpdateEmployeeInfo(NorthwindEmployee ne) {
bool retval = ne.Save();
if (!retval) { throw new NorthwindDataException("UpdateEmployee failed."); }
}
public static void DeleteEmployee(NorthwindEmployee ne) { }
}
public class NorthwindEmployee {
public NorthwindEmployee () {
ID = DBNull.Value;
lastName = "";
firstName = "";
title="";
titleOfCourtesy = "";
reportsTo = -1;
}
public NorthwindEmployee (object anID) {
this.ID = anID;
ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];
SqlConnection conn = new SqlConnection (cts.ConnectionString);
SqlCommand sc =
new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
" FROM Employees " +
" WHERE EmployeeID = @empId",
conn);
// Add the employee ID parameter and set its value.
sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
SqlDataReader sdr = null;
try {
conn.Open();
sdr = sc.ExecuteReader();
// This is not a while loop. It only loops once.
if (sdr != null && sdr.Read()) {
// The IEnumerable contains DataRowView objects.
this.firstName = sdr["FirstName"].ToString();
this.lastName = sdr["LastName"].ToString();
this.title = sdr["Title"].ToString();
this.titleOfCourtesy = sdr["TitleOfCourtesy"].ToString();
if (!sdr.IsDBNull(4)) {
this.reportsTo = sdr.GetInt32(4);
}
}
else {
throw new NorthwindDataException("Data not loaded for employee id.");
}
}
finally {
try {
if (sdr != null) sdr.Close();
conn.Close();
}
catch (SqlException) {
// Log an event in the Application Event Log.
throw;
}
}
}
private object ID;
private string lastName;
public string LastName {
get { return lastName; }
set { lastName = value; }
}
private string firstName;
public string FirstName {
get { return firstName; }
set { firstName = value; }
}
private string title;
public String Title {
get { return title; }
set { title = value; }
}
private string titleOfCourtesy;
public string Courtesy {
get { return titleOfCourtesy; }
set { titleOfCourtesy = value; }
}
private int reportsTo;
public int Supervisor {
get { return reportsTo; }
set { reportsTo = value; }
}
public bool Save () {
return true;
}
}
internal class NorthwindDataException: Exception {
public NorthwindDataException(string msg) : base (msg) { }
}
}
Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
' When the class is written in Visual Basic, you cannot use the Shared
' part.
Public Class EmployeeLogic
' Returns a collection of NorthwindEmployee objects.
Public Shared Function GetAllEmployees() As ICollection
Dim al As New ArrayList()
Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
Try
Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)
' Iterate through the Enumeration and create a
' NorthwindEmployee object for each ID.
For Each row As DataRowView In IDs
Dim id As String = row("EmployeeID").ToString()
Dim nwe As New NorthwindEmployee(id)
' Add the NorthwindEmployee object to the collection.
al.Add(nwe)
Next
Finally
' If anything strange happens, clean up.
sds.Dispose()
End Try
Return al
End Function 'GetAllEmployees
Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
Return New NorthwindEmployee(anID)
End Function 'GetEmployee
Public Shared Sub UpdateEmployeeInfo(ne As NorthwindEmployee)
Dim retval As Boolean = ne.Save()
If Not retval Then
Throw New NorthwindDataException("UpdateEmployee failed.")
End If
End Sub
Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
End Sub
End Class
Public Class NorthwindEmployee
Public Sub New()
ID = DBNull.Value
aLastName = ""
aFirstName = ""
aTitle = ""
titleOfCourtesy = ""
reportsTo = - 1
End Sub
Public Sub New(anID As Object)
Me.ID = anID
Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
Dim conn As New SqlConnection(cts.ConnectionString)
Dim sc As New SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " & _
" FROM Employees " & _
" WHERE EmployeeID = @empId", conn)
' Add the employee ID parameter and set its value.
sc.Parameters.Add(New SqlParameter("@empId", SqlDbType.Int)).Value = Int32.Parse(anID.ToString())
Dim sdr As SqlDataReader = Nothing
Try
conn.Open()
sdr = sc.ExecuteReader()
' This is not a while loop. It only loops once.
If Not (sdr Is Nothing) AndAlso sdr.Read() Then
' The IEnumerable contains DataRowView objects.
Me.aFirstName = sdr("FirstName").ToString()
Me.aLastName = sdr("LastName").ToString()
Me.aTitle = sdr("Title").ToString()
Me.titleOfCourtesy = sdr("TitleOfCourtesy").ToString()
If Not sdr.IsDBNull(4) Then
Me.reportsTo = sdr.GetInt32(4)
End If
Else
Throw New NorthwindDataException("Data not loaded for employee id.")
End If
Finally
Try
If Not (sdr Is Nothing) Then
sdr.Close()
End If
conn.Close()
Catch se As SqlException
' Log an event in the Application Event Log.
Throw
End Try
End Try
End Sub
Private ID As Object
Private aLastName As String
Public Property LastName() As String
Get
Return aLastName
End Get
Set
aLastName = value
End Set
End Property
Private aFirstName As String
Public Property FirstName() As String
Get
Return aFirstName
End Get
Set
aFirstName = value
End Set
End Property
Private aTitle As String
Public Property Title() As String
Get
Return aTitle
End Get
Set
aTitle = value
End Set
End Property
Private titleOfCourtesy As String
Public Property Courtesy() As String
Get
Return titleOfCourtesy
End Get
Set
titleOfCourtesy = value
End Set
End Property
Private reportsTo As Integer
Public Property Supervisor() As Integer
Get
Return reportsTo
End Get
Set
reportsTo = value
End Set
End Property
Public Function Save() As Boolean
Return True
End Function 'Save
End Class
Friend Class NorthwindDataException
Inherits Exception
Public Sub New(msg As String)
MyBase.New(msg)
End Sub
End Class
End Namespace
Commenti
In questo argomento:
Introduzione
Un ObjectDataSource controllo funziona con una classe creata. Si creano metodi che recuperano e aggiornano i dati e si forniscono i nomi di tali metodi al ObjectDataSource controllo nel markup. Durante il rendering o l'elaborazione postback, chiama ObjectDataSource i metodi specificati.
Non è disponibile alcun rendering visivo del ObjectDataSource controllo. Di conseguenza, non ObjectDataSource supporta le funzionalità visive, ad esempio la EnableTheming proprietà o SkinID .
Scopo
Una pratica di progettazione di applicazioni molto comune consiste nel separare il livello di presentazione dalla logica di business e incapsulare la logica di business negli oggetti business. Questi oggetti business formano un livello distinto tra il livello presentazione e il livello dati, ottenendo un'architettura dell'applicazione a tre livelli. Il ObjectDataSource controllo consente agli sviluppatori di usare un controllo origine dati ASP.NET mantenendo al tempo stesso l'architettura dell'applicazione a tre livelli.
Il ObjectDataSource controllo usa la reflection per creare istanze di oggetti business e per chiamare metodi su di essi per recuperare, aggiornare, inserire ed eliminare dati. La TypeName proprietà identifica il nome della classe utilizzata da .ObjectDataSource Il ObjectDataSource controllo crea ed elimina definitivamente un'istanza della classe per ogni chiamata al metodo; non contiene l'oggetto in memoria per la durata della richiesta Web. Si tratta di una considerazione seria se l'oggetto business usato richiede molte risorse o è altrimenti costoso da creare e distruggere. L'uso di un oggetto costoso potrebbe non essere una scelta di progettazione ottimale, ma è possibile controllare il ciclo di vita dell'oggetto usando gli ObjectCreatingeventi , ObjectCreatede ObjectDisposing .
Annotazioni
I metodi identificati dalle SelectMethodproprietà , UpdateMethodInsertMethod, e DeleteMethod possono essere metodi di istanza o static (Shared in Visual Basic). Se i metodi sono static (Shared in Visual Basic), non viene creata un'istanza dell'oggetto business e gli ObjectCreatingeventi , ObjectCreatede ObjectDisposing non vengono generati.
Recupero di dati
Per recuperare dati da un oggetto business, impostare la SelectMethod proprietà sul nome del metodo che recupera i dati. Se il metodo non restituisce un IEnumerable oggetto o DataSet , l'oggetto viene sottoposto a wrapping dal runtime in un IEnumerable insieme. Se la firma del metodo contiene parametri, è possibile aggiungere Parameter oggetti all'insieme SelectParameters e quindi associarli ai valori che si desidera passare al metodo specificato dalla SelectMethod proprietà . Affinché il ObjectDataSource controllo usi i parametri, i parametri devono corrispondere ai nomi e ai tipi dei parametri nella firma del metodo. Per altre informazioni, vedere Uso dei parametri con il controllo ObjectDataSource.
Il ObjectDataSource controllo recupera i dati ogni volta che viene chiamato il Select metodo . Questo metodo fornisce l'accesso a livello di codice al metodo specificato dalla SelectMethod proprietà . Il metodo specificato dalla SelectMethod proprietà viene chiamato automaticamente dai controlli associati a ObjectDataSource quando viene chiamato il metodo DataBind . Se si imposta la DataSourceID proprietà di un controllo associato a dati, il controllo viene associato automaticamente ai dati dall'origine dati, in base alle esigenze. L'impostazione della DataSourceID proprietà è il metodo consigliato per associare un ObjectDataSource controllo a un controllo associato a dati. In alternativa, è possibile impostare la DataSource proprietà , ma è necessario chiamare in modo esplicito il DataBind metodo del controllo associato a dati. È possibile chiamare il Select metodo a livello di codice in qualsiasi momento per recuperare i dati.
Per altre informazioni sull'associazione di controlli associati a dati ai controlli origine dati, vedere Associazione a dati tramite un controllo origine dati.
Esecuzione di operazioni dati
A seconda delle funzionalità dell'oggetto business usato dal ObjectDataSource controllo, è possibile eseguire operazioni sui dati, ad esempio aggiornamenti, inserimenti ed eliminazioni. Per eseguire queste operazioni sui dati, impostare il nome del metodo appropriato ed eventuali parametri associati per l'operazione che si desidera eseguire. Ad esempio, per un'operazione di aggiornamento, impostare la UpdateMethod proprietà sul nome del metodo dell'oggetto business che esegue gli aggiornamenti e aggiungere tutti i parametri necessari all'insieme UpdateParameters . Se il ObjectDataSource controllo è associato a un controllo associato a dati, i parametri vengono aggiunti dal controllo associato a dati. In questo caso, è necessario assicurarsi che i nomi dei parametri del metodo corrispondano ai nomi dei campi nel controllo associato a dati. L'aggiornamento viene eseguito quando il Update metodo viene chiamato, in modo esplicito dal codice o automaticamente da un controllo associato a dati. Lo stesso modello generale viene seguito per Delete le operazioni e Insert . Si presuppone che gli oggetti business eseguano questi tipi di operazioni di dati un record alla volta, anziché in batch.
Filtro dei dati
Il ObjectDataSource controllo può filtrare i dati recuperati dalla SelectMethod proprietà , se i dati vengono restituiti come DataSet oggetto o DataTable . È possibile impostare la FilterExpression proprietà su un'espressione di filtro usando una sintassi della stringa di formato e associare i valori nell'espressione ai parametri specificati nell'insieme FilterParameters .
Caching
ObjectDataSource Anche se non mantiene l'istanza dell'oggetto business tra più richieste, può memorizzare nella cache il risultato della chiamata al metodo identificato dalla SelectMethod proprietà . Mentre i dati vengono memorizzati nella cache, le chiamate successive al Select metodo restituiscono i dati memorizzati nella cache anziché creare l'oggetto business e chiamarne SelectMethod la reflection. La memorizzazione nella cache consente di evitare di creare l'oggetto e di chiamare il relativo metodo di dati a scapito della memoria nel server Web. Memorizza ObjectDataSource automaticamente nella cache i dati quando la EnableCaching proprietà è impostata su truee la CacheDuration proprietà viene impostata sul numero di secondi in cui la cache archivia i dati prima che la cache venga eliminata. È anche possibile specificare una CacheExpirationPolicy proprietà e una proprietà facoltativa SqlCacheDependency . Il ObjectDataSource controllo consente di memorizzare nella cache tutti i tipi di dati, ma non memorizzare nella cache oggetti che mantengono risorse o stato che non possono essere condivisi per gestire più richieste (ad esempio, un oggetto aperto SqlDataReader ), perché la stessa istanza dell'oggetto verrà usata per gestire più richieste.
Features
Nella tabella seguente vengono descritte le funzionalità del ObjectDataSource controllo .
| Capability | Requisiti |
|---|---|
| Selezione | Impostare la SelectMethod proprietà sul nome del metodo dell'oggetto business che seleziona i dati e includere tutti i parametri necessari nella raccolta a SelectParameters livello di codice o utilizzando un controllo associato a dati. |
| Ordinamento | Impostare la SortParameterName proprietà sul nome del parametro nel SelectMethod metodo che contiene i criteri di ordinamento. |
| Filtraggio | Impostare la FilterExpression proprietà su un'espressione di filtro e, facoltativamente, aggiungere eventuali parametri alla FilterParameters raccolta per filtrare i dati quando viene chiamato il Select metodo . Il metodo specificato dalla SelectMethod proprietà deve restituire un DataSet oggetto o DataTable. |
| Paging | Il paging dell'origine dati è supportato, se il SelectMethod metodo contiene parametri per il numero massimo di record da recuperare e l'indice del primo record da recuperare. I nomi di tali parametri devono essere impostati rispettivamente nelle MaximumRowsParameterName proprietà e StartRowIndexParameterName . Un controllo associato a dati potrebbe essere in grado di eseguire il paging stesso, anche se il ObjectDataSource controllo non supporta il paging direttamente nel metodo specificato dalla SelectMethod proprietà . Il requisito per consentire al controllo associato a dati di eseguire questa operazione è che il metodo specificato dalla SelectMethod proprietà restituisce un oggetto che implementa l'interfaccia ICollection . |
| Aggiornamento | Impostare la UpdateMethod proprietà sul nome del metodo dell'oggetto business che aggiorna i dati e includere tutti i parametri necessari nella UpdateParameters raccolta. |
| Deleting | Impostare la DeleteMethod proprietà sul nome del metodo o della funzione dell'oggetto business che elimina i dati e includere tutti i parametri necessari nella DeleteParameters raccolta. |
| Inserimento | Impostare la InsertMethod proprietà sul nome del metodo o della funzione dell'oggetto business che inserisce i dati e includere tutti i parametri necessari nella InsertParameters raccolta. |
| Caching | Impostare la EnableCaching proprietà su truee le CacheDuration proprietà e CacheExpirationPolicy in base al comportamento di memorizzazione nella cache desiderato per i dati memorizzati nella cache. |
Annotazioni
Quando si utilizza la ObjectDataSource classe per aggiornare o inserire dati, le stringhe immesse nel client non vengono convertite automaticamente dal formato delle impostazioni cultura client al formato delle impostazioni cultura del server. Ad esempio, le impostazioni cultura client potrebbero specificare GG/MM/AAAA come formato data e il formato della data nel server potrebbe essere MM/GG/AAAA. In tal caso, il 5 ottobre 2009 verrebbe inserito in un TextBox controllo come 10/5/05/2009, ma verrebbe interpretato come 10 maggio 2009. Il 15 ottobre 2009 verrebbe inserito come 15/10/2009 e verrebbe rifiutato come data non valida.
Visualizzazione dati
Come per tutti i controlli origine dati, il ObjectDataSource controllo è associato a una classe di vista origine dati. Mentre il ObjectDataSource controllo è l'interfaccia usata dallo sviluppatore della pagina per lavorare con i dati, la ObjectDataSourceView classe è l'interfaccia con cui i controlli associati a dati funzionano. Inoltre, la ObjectDataSourceView classe descrive le funzionalità del controllo origine dati ed esegue il lavoro effettivo. Il ObjectDataSource controllo ha solo un oggetto associato ObjectDataSourceViewed è sempre denominato DefaultView. Mentre l'oggetto ObjectDataSourceView viene esposto dal GetView metodo , molti dei relativi metodi e proprietà vengono sottoposti a wrapping ed esposti direttamente dal ObjectDataSource controllo . Dietro le quinte, l'oggetto ObjectDataSourceView esegue tutte le operazioni sui dati, inclusi il recupero, l'inserimento, l'aggiornamento, l'eliminazione, il filtro e l'ordinamento dei dati. Per altre informazioni, vedere ObjectDataSourceView.
Uso di LINQ to SQL
È possibile usare il ObjectDataSource controllo con una classe LINQ to SQL. A tale scopo, impostare la TypeName proprietà sul nome della classe del contesto dati. È anche possibile impostare i SelectMethodmetodi , UpdateMethodInsertMethod, e DeleteMethod sui metodi nella classe del contesto dati che eseguono le operazioni corrispondenti. Per annullare l'eliminazione della classe del contesto dati, è necessario creare un gestore eventi per l'evento ObjectDisposing . Questo passaggio è necessario perché LINQ to SQL supporta l'esecuzione posticipata, mentre il ObjectDataSource controllo tenta di eliminare il contesto dei dati dopo l'operazione Select. Per altre informazioni su come creare classi LINQ to SQL, vedere Procedura: Creare classi LINQ to SQL in un progetto Web. Per un esempio di come annullare l'eliminazione di una classe del contesto dati, vedere l'evento ObjectDisposing .
Uso di Entity Framework
È anche possibile usare il ObjectDataSource controllo con Entity Framework. Per altre informazioni, vedere Uso di Entity Framework e del controllo ObjectDataSource.
Sintassi dichiarativa
<asp:ObjectDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
ConflictDetection="OverwriteChanges|CompareAllValues"
ConvertNullToDBNull="True|False"
DataObjectTypeName="string"
DeleteMethod="string"
EnableCaching="True|False"
EnablePaging="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FilterExpression="string"
ID="string"
InsertMethod="string"
MaximumRowsParameterName="string"
OldValuesParameterFormatString="string"
OnDataBinding="DataBinding event handler"
OnDeleted="Deleted event handler"
OnDeleting="Deleting event handler"
OnDisposed="Disposed event handler"
OnFiltering="Filtering event handler"
OnInit="Init event handler"
OnInserted="Inserted event handler"
OnInserting="Inserting event handler"
OnLoad="Load event handler"
OnObjectCreated="ObjectCreated event handler"
OnObjectCreating="ObjectCreating event handler"
OnObjectDisposing="ObjectDisposing event handler"
OnPreRender="PreRender event handler"
OnSelected="Selected event handler"
OnSelecting="Selecting event handler"
OnUnload="Unload event handler"
OnUpdated="Updated event handler"
OnUpdating="Updating event handler"
runat="server"
SelectCountMethod="string"
SelectMethod="string"
SkinID="string"
SortParameterName="string"
SqlCacheDependency="string"
StartRowIndexParameterName="string"
TypeName="string"
UpdateMethod="string"
Visible="True|False"
>
<DeleteParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</DeleteParameters>
<FilterParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</FilterParameters>
<InsertParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</InsertParameters>
<SelectParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</SelectParameters>
<UpdateParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</UpdateParameters>
</asp:ObjectDataSource>
Costruttori
| Nome | Descrizione |
|---|---|
| ObjectDataSource() |
Inizializza una nuova istanza della classe ObjectDataSource. |
| ObjectDataSource(String, String) |
Inizializza una nuova istanza della ObjectDataSource classe con il nome del tipo e il nome del metodo di recupero dati specificati. |
Proprietà
| Nome | Descrizione |
|---|---|
| Adapter |
Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control) |
| AppRelativeTemplateSourceDirectory |
Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control) |
| BindingContainer |
Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control) |
| CacheDuration |
Ottiene o imposta l'intervallo di tempo, espresso in secondi, durante il quale il controllo origine dati memorizza nella cache i dati recuperati dalla SelectMethod proprietà . |
| CacheExpirationPolicy |
Ottiene o imposta il comportamento di scadenza della cache che, in combinazione con la durata, descrive il comportamento della cache utilizzata dal controllo origine dati. |
| CacheKeyDependency |
Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti della cache dei dati creati dal controllo origine dati. |
| ChildControlsCreated |
Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control) |
| ClientID |
Ottiene l'identificatore del controllo server generato da ASP.NET. (Ereditato da DataSourceControl) |
| ClientIDMode |
Questa proprietà non viene utilizzata per i controlli origine dati. (Ereditato da DataSourceControl) |
| ClientIDSeparator |
Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control) |
| ConflictDetection |
Ottiene o imposta un valore che determina se al metodo vengono passati |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da DataSourceControl) |
| ConvertNullToDBNull |
Ottiene o imposta un valore che indica se i Parameter valori passati a un'operazione di aggiornamento, inserimento o eliminazione vengono convertiti automaticamente da |
| DataItemContainer |
Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control) |
| DataKeysContainer |
Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control) |
| DataObjectTypeName |
Ottiene o imposta il nome di una classe utilizzata dal ObjectDataSource controllo per un parametro in un'operazione di aggiornamento, inserimento o eliminazione dei dati, anziché passare singoli valori dal controllo associato a dati. |
| DeleteMethod |
Ottiene o imposta il nome del metodo o della funzione richiamato dal ObjectDataSource controllo per eliminare i dati. |
| DeleteParameters |
Ottiene l'insieme di parametri che contiene i parametri utilizzati dal DeleteMethod metodo . |
| DesignMode |
Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control) |
| EnableCaching |
Ottiene o imposta un valore che indica se il controllo dispone di ObjectDataSource memorizzazione nella cache dei dati abilitata. |
| EnablePaging |
Ottiene o imposta un valore che indica se il controllo origine dati supporta il paging tramite il set di dati recuperati. |
| EnableTheming |
Ottiene un valore che indica se questo controllo supporta i temi. (Ereditato da DataSourceControl) |
| EnableViewState |
Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control) |
| Events |
Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control) |
| FilterExpression |
Ottiene o imposta un'espressione di filtro applicata quando viene chiamato il metodo specificato dalla SelectMethod proprietà . |
| FilterParameters |
Ottiene una raccolta di parametri associati a qualsiasi segnaposto di parametro nella FilterExpression stringa. |
| HasChildViewState |
Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control) |
| ID |
Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control) |
| IdSeparator |
Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control) |
| InsertMethod |
Ottiene o imposta il nome del metodo o della funzione richiamato dal ObjectDataSource controllo per inserire i dati. |
| InsertParameters |
Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla InsertMethod proprietà . |
| IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control) |
| IsTrackingViewState |
Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control) |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control) |
| MaximumRowsParameterName |
Ottiene o imposta il nome del parametro del metodo di recupero dati dell'oggetto business utilizzato per indicare il numero di record da recuperare per il supporto del paging dell'origine dati. |
| NamingContainer |
Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control) |
| OldValuesParameterFormatString |
Ottiene o imposta una stringa di formato da applicare ai nomi dei parametri per i valori originali passati ai |
| Page |
Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control) |
| Parent |
Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control) |
| ParsingCulture |
Ottiene un valore o imposta un valore che indica le informazioni sulle impostazioni cultura utilizzate durante la conversione dei valori stringa in tipi di proprietà effettivi per costruire un oggetto del tipo indicato da DataObjectTypeName. |
| RenderingCompatibility |
Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control) |
| SelectCountMethod |
Ottiene o imposta il nome del metodo o della funzione richiamato dal ObjectDataSource controllo per recuperare un conteggio delle righe. |
| SelectMethod |
Ottiene o imposta il nome del metodo o della funzione richiamato dal ObjectDataSource controllo per recuperare i dati. |
| SelectParameters |
Ottiene una raccolta di parametri utilizzati dal metodo specificato dalla SelectMethod proprietà . |
| Site |
Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene l'interfaccia da applicare al DataSourceControl controllo. (Ereditato da DataSourceControl) |
| SortParameterName |
Ottiene o imposta il nome dell'oggetto business utilizzato dal SelectMethod parametro per specificare un'espressione di ordinamento per il supporto dell'ordinamento dell'origine dati. |
| SqlCacheDependency |
Ottiene o imposta una stringa delimitata da punto e virgola che indica quali database e tabelle utilizzare per la dipendenza della cache di Microsoft SQL Server. |
| StartRowIndexParameterName |
Ottiene o imposta il nome del parametro del metodo di recupero dati utilizzato per indicare il valore dell'identificatore del primo record da recuperare per il supporto del paging dell'origine dati. |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control) |
| TypeName |
Ottiene o imposta il nome della classe rappresentata dall'oggetto ObjectDataSource . |
| UniqueID |
Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control) |
| UpdateMethod |
Ottiene o imposta il nome del metodo o della funzione richiamato dal ObjectDataSource controllo per aggiornare i dati. |
| UpdateParameters |
Ottiene l'insieme di parametri che contiene i parametri utilizzati dal metodo specificato dalla UpdateMethod proprietà . |
| ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Ottiene o imposta un valore che indica se il controllo viene visualizzato visivamente. (Ereditato da DataSourceControl) |
Metodi
| Nome | Descrizione |
|---|---|
| AddedControl(Control, Int32) |
Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| AddParsedSubObject(Object) |
Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control) |
| ApplyStyleSheetSkin(Page) |
Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| BuildProfileTree(String, Boolean) |
Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control) |
| ClearCachedClientID() |
Imposta il valore memorizzato nella ClientID cache su |
| ClearChildControlState() |
Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildState() |
Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildViewState() |
Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearEffectiveClientIDMode() |
Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control) |
| CreateChildControls() |
Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control) |
| CreateControlCollection() |
Crea una raccolta per archiviare i controlli figlio. (Ereditato da DataSourceControl) |
| DataBind() |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control) |
| DataBind(Boolean) |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control) |
| Delete() |
Esegue un'operazione di eliminazione chiamando il metodo identificato dalla DeleteMethod proprietà con tutti i parametri presenti nell'insieme DeleteParameters . |
| Dispose() |
Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control) |
| EndRenderTracing(TextWriter, Object) |
Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| EnsureChildControls() |
Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control) |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato |
| FindControl(String) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato |
| Focus() |
Imposta lo stato attivo per l'input sul controllo. (Ereditato da DataSourceControl) |
| GetDesignModeState() |
Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRouteUrl(Object) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(String, Object) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control) |
| GetView(String) |
Recupera la vista origine dati denominata associata al controllo origine dati. |
| GetViewNames() |
Recupera un insieme di nomi che rappresentano l'elenco di oggetti visualizzazione associati all'oggetto ObjectDataSource . |
| HasControls() |
Determina se il controllo server contiene controlli figlio. (Ereditato da DataSourceControl) |
| HasEvents() |
Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control) |
| Insert() |
Esegue un'operazione di inserimento chiamando il metodo identificato dalla InsertMethod proprietà ed eventuali parametri nell'insieme InsertParameters . |
| IsLiteralContent() |
Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control) |
| LoadControlState(Object) |
Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control) |
| LoadViewState(Object) |
Carica lo stato di visualizzazione salvato in precedenza del ObjectDataSource controllo. |
| MapPathSecure(String) |
Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnInit(EventArgs) |
Aggiunge un LoadComplete gestore eventi alla pagina che contiene il ObjectDataSource controllo . |
| OnLoad(EventArgs) |
Genera l'evento Load. (Ereditato da Control) |
| OnPreRender(EventArgs) |
Genera l'evento PreRender. (Ereditato da Control) |
| OnUnload(EventArgs) |
Genera l'evento Unload. (Ereditato da Control) |
| OpenFile(String) |
Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Genera l'evento DataSourceChanged. (Ereditato da DataSourceControl) |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| Render(HtmlTextWriter) |
Invia il contenuto del controllo server a un oggetto specificato HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da DataSourceControl) |
| ResolveAdapter() |
Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control) |
| ResolveClientUrl(String) |
Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control) |
| ResolveUrl(String) |
Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control) |
| SaveViewState() |
Salva lo stato del ObjectDataSource controllo. |
| Select() |
Recupera i dati dall'archivio dati sottostante chiamando il metodo identificato dalla SelectMethod proprietà con i parametri nella SelectParameters raccolta. |
| SetDesignModeState(IDictionary) |
Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| SetRenderMethodDelegate(RenderMethod) |
Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control) |
| SetTraceData(Object, Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| SetTraceData(Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TrackViewState() |
Tiene traccia delle modifiche dello stato di visualizzazione al ObjectDataSource controllo in modo che possano essere archiviate nell'oggetto StateBag . |
| Update() |
Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla UpdateMethod proprietà ed eventuali parametri presenti nell'insieme UpdateParameters . |
Eventi
| Nome | Descrizione |
|---|---|
| DataBinding |
Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
| Deleted |
Si verifica quando un'operazione Delete() è stata completata. |
| Deleting |
Si verifica prima di un'operazione Delete() . |
| Disposed |
Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
| Filtering |
Si verifica prima di un'operazione di filtro. |
| Init |
Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control) |
| Inserted |
Si verifica quando un'operazione Insert() è stata completata. |
| Inserting |
Si verifica prima di un'operazione Insert() . |
| Load |
Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control) |
| ObjectCreated |
Si verifica dopo la TypeName creazione dell'oggetto identificato dalla proprietà . |
| ObjectCreating |
Si verifica prima della creazione dell'oggetto TypeName identificato dalla proprietà . |
| ObjectDisposing |
Si verifica prima dell'eliminazione dell'oggetto identificato dalla TypeName proprietà . |
| PreRender |
Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control) |
| Selected |
Si verifica quando un'operazione Select() è stata completata. |
| Selecting |
Si verifica prima di un'operazione Select() . |
| Unload |
Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
| Updated |
Si verifica quando un'operazione Update() è stata completata. |
| Updating |
Si verifica prima di un'operazione Update() . |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control) |
| IControlDesignerAccessor.UserData |
Per una descrizione di questo membro, vedere UserData. (Ereditato da Control) |
| IDataBindingsAccessor.DataBindings |
Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control) |
| IDataBindingsAccessor.HasDataBindings |
Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control) |
| IDataSource.DataSourceChanged |
Si verifica quando un controllo origine dati è stato modificato in modo da influire sui controlli associati a dati. (Ereditato da DataSourceControl) |
| IDataSource.GetView(String) |
Ottiene l'oggetto denominato DataSourceView associato al DataSourceControl controllo . Alcuni controlli origine dati supportano una sola visualizzazione, mentre altri supportano più di uno. (Ereditato da DataSourceControl) |
| IDataSource.GetViewNames() |
Ottiene una raccolta di nomi, che rappresenta l'elenco di DataSourceView oggetti associati al DataSourceControl controllo . (Ereditato da DataSourceControl) |
| IExpressionsAccessor.Expressions |
Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control) |
| IExpressionsAccessor.HasExpressions |
Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control) |
| IListSource.ContainsListCollection |
Indica se il controllo origine dati è associato a uno o più elenchi di dati. (Ereditato da DataSourceControl) |
| IListSource.GetList() |
Ottiene un elenco di controlli origine dati che possono essere utilizzati come origini di elenchi di dati. (Ereditato da DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| FindDataSourceControl(Control) |
Restituisce l'origine dati associata al controllo dati per il controllo specificato. |
| FindFieldTemplate(Control, String) |
Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. |
| FindMetaTable(Control) |
Restituisce l'oggetto metatable per il controllo dati contenitore. |
| GetDefaultValues(IDataSource) |
Ottiene la raccolta dei valori predefiniti per l'origine dati specificata. |
| GetMetaTable(IDataSource) |
Ottiene i metadati per una tabella nell'oggetto origine dati specificato. |
| TryGetMetaTable(IDataSource, MetaTable) |
Determina se i metadati della tabella sono disponibili. |
Si applica a
Vedi anche
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Procedura dettagliata: data binding a un oggetto business personalizzato
- Controlli server Web origine dati
- Cenni preliminari sul controllo ObjectDataSource
- Creazione di un oggetto origine del controllo ObjectDataSource
- Uso di Entity Framework e del controllo ObjectDataSource
