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 con associazione a dati in 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 ObjectDataSource markup in una pagina con estensione aspx e mostra gli oggetti business che funzionano con. 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 usato 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'utente ObjectDataSource .La
NorthwindEmployeeclasse definisce l'oggetto dati restituito dalGetAllEmployeesmetodo dellaEmployeeLogicclasse.
Una classe aggiuntiva NorthwindDataException viene fornita come 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 l'elaborazione di rendering o postback, le chiamate ai ObjectDataSource metodi specificati.
Non è disponibile alcun rendering visivo del ObjectDataSource controllo. Di conseguenza, l'oggetto ObjectDataSource non supporta 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 di presentazione e il livello dati, causando un'architettura dell'applicazione a tre livelli. Il ObjectDataSource controllo consente agli sviluppatori di usare un controllo origine dati ASP.NET mantenendo l'architettura dell'applicazione a tre livelli.
Il ObjectDataSource controllo usa la reflection per creare istanze di oggetti business e chiamare metodi su di essi per recuperare, aggiornare, inserire ed eliminare i dati. La TypeName proprietà identifica il nome della classe con cui funziona ObjectDataSource . Il ObjectDataSource controllo crea ed elimina un'istanza della classe per ogni chiamata di metodo. Non contiene l'oggetto in memoria per la durata della richiesta Web. Si tratta di una considerazione grave se l'oggetto business che si usa richiede molte risorse o è altrimenti costoso per 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 ObjectCreating, ObjectCreateded ObjectDisposing eventi.
Nota
I metodi identificati dalle SelectMethodproprietà , , InsertMethodUpdateMethode 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 ObjectCreatingdell'oggetto business e gli eventi , ObjectCreatede ObjectDisposing non vengono generati.
Recupero di dati
Per recuperare i 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 include parametri, è possibile aggiungere Parameter oggetti all'insieme SelectParametersSelectMethod e quindi associarli ai valori che si desidera passare al metodo specificato dalla 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 di 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 proprietà viene chiamato automaticamente dai controlli associati all'oggetto SelectMethod quando viene chiamato il ObjectDataSourceDataBind metodo. Se si imposta la DataSourceID proprietà di un controllo associato a dati, il controllo viene automaticamente associato ai dati dall'origine dati, in base alle esigenze. L'impostazione della DataSourceID proprietà è il metodo consigliato per associare un controllo a un ObjectDataSource 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 metodo a livello di Select codice in qualsiasi momento per recuperare i dati.
Per altre informazioni sul binding dei controlli associati ai dati ai controlli dell'origine dati, vedere Associazione ai dati tramite un controllo origine dati.
Esecuzione di operazioni dati
A seconda delle funzionalità dell'oggetto business con cui il ObjectDataSource controllo funziona, è possibile eseguire operazioni sui dati, ad esempio aggiornamenti, inserimenti ed eliminazioni. Per eseguire queste operazioni sui dati, impostare il nome del metodo appropriato e tutti i parametri associati per l'operazione da 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 alla UpdateParameters raccolta. Se il ObjectDataSource controllo è associato a un controllo associato ai dati, i parametri vengono aggiunti dal controllo associato ai 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 viene chiamato il Update metodo, in modo esplicito dal codice o automaticamente da un controllo associato a dati. Lo stesso modello generale viene seguito per Delete e Insert operazioni. Si presuppone che gli oggetti business eseguano questi tipi di operazioni di dati un record alla volta, anziché in batch.
Filtraggio dei dati
Il ObjectDataSource controllo può filtrare i dati recuperati dalla SelectMethod proprietà, se i dati vengono restituiti come oggetto DataSet o DataTable . È possibile impostare la FilterExpression proprietà su un'espressione di filtro usando una sintassi stringa di formato e associare i valori nell'espressione ai parametri specificati nell'insieme FilterParameters .
Memorizzazione nella cache
Anche se l'oggetto ObjectDataSource business non mantiene l'istanza dell'oggetto business in più richieste, può memorizzare nella cache il risultato della chiamata al SelectMethod metodo identificato dalla 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 chiamare il relativo metodo di dati a spese della memoria nel server Web. I ObjectDataSource dati vengono memorizzati automaticamente nella cache quando la EnableCaching proprietà è impostata su truee la CacheDuration proprietà è impostata sul numero di secondi in cui la cache archivia i dati prima che la cache venga eliminata. È anche possibile specificare una proprietà e una CacheExpirationPolicy proprietà facoltativa SqlCacheDependency . Il ObjectDataSource controllo consente di memorizzare nella cache tutti i tipi di dati, ma non è necessario memorizzare nella cache gli oggetti che mantengono risorse o stato che non possono essere condivisi per eseguire più richieste, ad esempio un oggetto aperto SqlDataReader , perché la stessa istanza dell'oggetto verrà usata per eseguire più richieste.
Funzionalità
Nella tabella seguente vengono descritte le funzionalità del ObjectDataSource controllo.
| Funzionalità | Requisiti |
|---|---|
| Selezionare: | Impostare la SelectMethod proprietà sul nome del metodo dell'oggetto business che seleziona i dati e includere i parametri necessari nella SelectParameters raccolta a livello di codice o usando un controllo associato a dati. |
| Ordinamento | Impostare la SortParameterName proprietà sul nome del parametro nel SelectMethod metodo che contiene i criteri di ordinamento. |
| Filtro | Impostare la FilterExpression proprietà su un'espressione di filtro e aggiungere facoltativamente tutti i 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 questi 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 il controllo associato a dati è 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. |
| Memorizzazione nella cache | Impostare la EnableCaching proprietà su truee le CacheDuration proprietà e CacheExpirationPolicy in base al comportamento di memorizzazione nella cache dei dati memorizzati nella cache. |
Nota
Quando si usa la ObjectDataSource classe per aggiornare o inserire dati, le stringhe immesse nel client non vengono convertite automaticamente dal formato impostazioni cultura client al formato impostazioni cultura server. Ad esempio, le impostazioni cultura client potrebbero specificare DD/MM/AAAA come formato data e il formato data nel server potrebbe essere MM/DD/YAAA. In tal caso, il 5 ottobre 2009 verrebbe immesso in un TextBox controllo come 5/10/2009, ma sarebbe interpretato come 10 maggio 2009. Il 15 ottobre 2009 verrebbe immesso come 15/10/2009 e sarebbe stato rifiutato come data non valida.
Vista dati
Come per tutti i controlli origine dati, il ObjectDataSource controllo è associato a una classe di visualizzazione origine dati. Anche se il ObjectDataSource controllo è l'interfaccia usata dallo sviluppatore di pagine per lavorare con i dati, la ObjectDataSourceView classe è l'interfaccia con cui i controlli associati ai dati funzionano. Inoltre, la ObjectDataSourceView classe descrive le funzionalità del controllo origine dati ed esegue il lavoro effettivo. Il ObjectDataSource controllo ha un solo oggetto associato ObjectDataSourceViewed è sempre denominato DefaultView. Mentre l'oggetto ObjectDataSourceViewGetView viene esposto dal metodo, molti dei relativi metodi e proprietà vengono sottoposti a wrapping e esposti direttamente dal ObjectDataSource controllo. Dietro le quinte, l'oggetto ObjectDataSourceView esegue tutte le operazioni di dati, tra cui recupero, inserimento, aggiornamento, eliminazione, filtro e 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. È necessario creare un gestore eventi per l'evento per annullare l'eliminazione ObjectDisposing della classe del contesto dati. Questo passaggio è necessario perché LINQ to SQL supporta l'esecuzione posticipata, mentre il ObjectDataSource controllo tenta di eliminare il contesto 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 di 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
| ObjectDataSource() |
Inizializza una nuova istanza della classe ObjectDataSource. |
| ObjectDataSource(String, String) |
Inizializza una nuova istanza della classe ObjectDataSource con il nome del tipo e il nome di metodo relativo al recupero dati specificati. |
Proprietà
| 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 contenente questo controllo. (Ereditato da Control) |
| BindingContainer |
Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control) |
| CacheDuration |
Ottiene o imposta il numero di secondi durante i quali il controllo origine dati memorizza nella cache i dati recuperati dalla proprietà SelectMethod. |
| CacheExpirationPolicy |
Ottiene o imposta il comportamento di scadenza della cache che, quando combinato con la durata, descrive il comportamento della cache utilizzato dal controllo origine dati. |
| CacheKeyDependency |
Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti cache dati creati dal controllo origine dati. |
| ChildControlsCreated |
Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (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 carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control) |
| ConflictDetection |
Ottiene o imposta un valore che determina se al metodo |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da DataSourceControl) |
| ConvertNullToDBNull |
Ottiene o imposta un valore indicante se i valori Parameter 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 controllo ObjectDataSource per un parametro in un'operazione sui dati di aggiornamento, inserimento o eliminazione, invece di passare singoli valori dal controllo con associazione a dati. |
| DeleteMethod |
Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per eliminare dati. |
| DeleteParameters |
Ottiene l'insieme di parametri contenente i parametri utilizzati dal metodo DeleteMethod. |
| 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 indicante se la memorizzazione di dati nella cache è abilitata nel controllo ObjectDataSource. |
| EnablePaging |
Ottiene o imposta un valore indicante se il controllo origine dati supporta il paging dell'insieme di dati recuperati. |
| EnableTheming |
Ottiene un valore che indica se il controllo supporta i temi. (Ereditato da DataSourceControl) |
| EnableViewState |
Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control) |
| Events |
Ottiene un elenco dei 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 il metodo specificato dalla proprietà SelectMethod viene chiamato. |
| FilterParameters |
Ottiene un insieme di parametri associati ai segnaposto di parametro nella stringa FilterExpression. |
| HasChildViewState |
Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control) |
| ID |
Ottiene o imposta l'identificatore a livello di codice 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 funzione che il controllo ObjectDataSource richiama per inserire dati. |
| InsertParameters |
Ottiene l'insieme di parametri contenente i parametri utilizzati dalla proprietà InsertMethod. |
| IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control) |
| IsTrackingViewState |
Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control) |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control) |
| MaximumRowsParameterName |
Ottiene o imposta il nome di parametro del metodo di recupero dati dell'oggetto business utilizzato per indicare il numero di record da recuperare per il supporto paging dell'origine dati. |
| NamingContainer |
Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID. (Ereditato da Control) |
| OldValuesParameterFormatString |
Ottiene o imposta una stringa di formato da applicare ai nomi dei parametri per i valori originali passati ai metodi |
| 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 della pagina. (Ereditato da Control) |
| ParsingCulture |
Ottiene un oggetto o imposta un valore che indica le informazioni sulle impostazioni cultura utilizzate quando si convertono i valori stringa in tipi di proprietà effettivi per costruire un oggetto del tipo indicato da DataObjectTypeName. |
| RenderingCompatibility |
Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control) |
| SelectCountMethod |
Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per recuperare un numero di righe. |
| SelectMethod |
Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per recuperare i dati. |
| SelectParameters |
Ottiene un insieme di parametri utilizzati dal metodo specificato dalla proprietà SelectMethod. |
| Site |
Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene l'interfaccia da applicare al controllo DataSourceControl. (Ereditato da DataSourceControl) |
| SortParameterName |
Ottiene o imposta il nome dell'oggetto business utilizzato dal parametro SelectMethod per specificare un'espressione di ordinamento per il supporto di ordinamento dell'origine dati. |
| SqlCacheDependency |
Ottiene o imposta una stringa delimitata da punti e virgola che indica i database e le tabelle da utilizzare per la dipendenza della cache da Microsoft SQL Server. |
| StartRowIndexParameterName |
Ottiene o imposta il nome di parametro del metodo di recupero dati utilizzato per indicare il valore dell'identificatore del primo record da recuperare per il supporto paging dell'origine dati. |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o dell'oggetto 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 qualificato gerarchicamente per il controllo server. (Ereditato da Control) |
| UpdateMethod |
Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per aggiornare i dati. |
| UpdateParameters |
Ottiene l'insieme di parametri contenente i parametri utilizzati dal metodo specificato dalla proprietà UpdateMethod. |
| ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Ottiene o imposta un valore che indica se il controllo è visualizzato. (Ereditato da DataSourceControl) |
Metodi
| AddedControl(Control, Int32) |
Chiamato dopo che un controllo figlio viene aggiunto alla raccolta 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 ControlCollection del controllo server. (Ereditato da Control) |
| ApplyStyleSheetSkin(Page) |
Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (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 recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control) |
| ClearCachedClientID() |
Imposta il valore memorizzato nella cache ClientID 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 proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control) |
| CreateChildControls() |
Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering. (Ereditato da Control) |
| CreateControlCollection() |
Crea una raccolta per l'archiviazione di controlli figlio. (Ereditato da DataSourceControl) |
| DataBind() |
Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio. (Ereditato da Control) |
| DataBind(Boolean) |
Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control) |
| Delete() |
Esegue un'operazione di eliminazione chiamando il metodo identificato dalla proprietà DeleteMethod con i parametri contenuti nell'insieme DeleteParameters. |
| Dispose() |
Abilita un controllo server alla pulizia finale prima che venga rilasciato 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, li crea. (Ereditato da Control) |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindControl(String) |
Cerca un controllo server nel contenitore dei nomi corrente con il parametro |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro |
| Focus() |
Imposta lo stato attivo per l'input del controllo. (Ereditato da DataSourceControl) |
| GetDesignModeState() |
Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRouteUrl(Object) |
Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL corrispondente 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 a un nome della route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control) |
| GetView(String) |
Recupera la visualizzazione 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 eventuali controlli figlio. (Ereditato da Control) |
| Insert() |
Esegue un'operazione di inserimento chiamando il metodo identificato dalla proprietà InsertMethod e dai parametri nell'insieme InsertParameters. |
| IsLiteralContent() |
Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control) |
| LoadControlState(Object) |
Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState(). (Ereditato da Control) |
| LoadViewState(Object) |
Carica lo stato di visualizzazione precedentemente salvato del controllo ObjectDataSource. |
| MapPathSecure(String) |
Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina. (Ereditato da Control) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnInit(EventArgs) |
Aggiunge un gestore eventi LoadComplete alla pagina che contiene il controllo ObjectDataSource. |
| 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 oggetto Stream utilizzato per leggere un file. (Ereditato da Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Genera l'evento DataSourceChanged. (Ereditato da DataSourceControl) |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control. (Ereditato da Control) |
| Render(HtmlTextWriter) |
Invia il contenuto del controllo server a un oggetto HtmlTextWriter specificato 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 a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da DataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control) |
| ResolveAdapter() |
Ottiene l'adattatore del 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 formato utilizzabile dal client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server. (Ereditato da Control) |
| SaveViewState() |
Salva lo stato del controllo ObjectDataSource. |
| Select() |
Recupera i dati dall'archivio dati sottostante chiamando il metodo identificato dalla proprietà SelectMethod con i parametri nell'insieme SelectParameters. |
| SetDesignModeState(IDictionary) |
Imposta i dati della 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) |
Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| SetTraceData(Object, Object, Object) |
Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, 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 apportate al controllo ObjectDataSource in modo che possano essere memorizzate nell'oggetto StateBag. |
| Update() |
Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla proprietà UpdateMethod e dai parametri contenuti nell'insieme UpdateParameters. |
Eventi
| DataBinding |
Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
| Deleted |
Si verifica quando viene completata un'operazione Delete(). |
| Deleting |
Si verifica prima di un'operazione Delete(). |
| Disposed |
Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
| Filtering |
Si verifica prima di un'operazione di filtro. |
| Init |
Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control) |
| Inserted |
Si verifica quando viene completata un'operazione Insert(). |
| Inserting |
Si verifica prima di un'operazione Insert(). |
| Load |
Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control) |
| ObjectCreated |
Si verifica dopo la creazione dell'oggetto identificato dalla proprietà TypeName. |
| ObjectCreating |
Si verifica prima della creazione dell'oggetto identificato dalla proprietà TypeName. |
| ObjectDisposing |
Si verifica prima dell'eliminazione dell'oggetto identificato dalla proprietà TypeName. |
| PreRender |
Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control) |
| Selected |
Si verifica quando viene completata un'operazione Select(). |
| Selecting |
Si verifica prima di un'operazione Select(). |
| Unload |
Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
| Updated |
Si verifica quando viene completata un'operazione Update(). |
| Updating |
Si verifica prima di un'operazione Update(). |
Implementazioni dell'interfaccia esplicita
| 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 a un controllo origine dati sono state apportate modifiche che influiscono sui controlli con associazione a dati. (Ereditato da DataSourceControl) |
| IDataSource.GetView(String) |
Ottiene l'oggetto DataSourceView denominato associato al controllo DataSourceControl. Alcuni controlli origine dati supportano una sola visualizzazione, mentre altri ne supportano più di una. (Ereditato da DataSourceControl) |
| IDataSource.GetViewNames() |
Ottiene un insieme di nomi che rappresentano l'elenco di oggetti DataSourceView associati al controllo DataSourceControl. (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 degli elenchi di dati. (Ereditato da DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control) |
Metodi di estensione
| 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 metatabella per il controllo contenitore dei dati. |
| GetDefaultValues(IDataSource) |
Ottiene l'insieme di 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 sono disponibili i metadati della tabella. |
Si applica a
Vedi anche
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Procedura dettagliata: data binding a un oggetto business personalizzato
- Controlli server Web dell'origine dati
- Cenni preliminari sul controllo ObjectDataSource
- Creazione di un oggetto di origine del controllo ObjectDataSource
- Uso di Entity Framework e del controllo ObjectDataSource
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per