ObjectDataSource Classe

Definizione

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 DataSourceControl
Public Class ObjectDataSource
Inherits DataSourceControl
Ereditarietà
ObjectDataSource
Attributi

Esempio

Questa sezione mostra un ObjectDataSource oggetto 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 EmployeeLogic classe è la classe della logica di business usata dall'oggetto ObjectDataSource .

  • La NorthwindEmployee classe definisce l'oggetto dati restituito dal GetAllEmployees metodo della EmployeeLogic classe .

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 funzionante 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 contesto dati. È anche possibile impostare i SelectMethodmetodi , UpdateMethod, InsertMethode DeleteMethod sui metodi nella classe contesto dati che eseguono le operazioni corrispondenti. È necessario creare un gestore eventi per l'evento ObjectDisposing per annullare la eliminazione della classe contesto dati. Questo passaggio è necessario perché LINQ to SQL supporta l'esecuzione posticipata, mentre il controllo tenta di eliminare il ObjectDataSource 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 la 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 Update vengono passati solo i nuovi valori o se al metodo Update vengono passati sia i valori obsoleti che nuovi.

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 null nel valore Value dal controllo ObjectDataSource.

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 Delete o Update.

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 null.

(Ereditato da Control)
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 id specificato.

(Ereditato da DataSourceControl)
FindControl(String, Int32)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl.

(Ereditato da Control)
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