ObjectDataSource Classe

Definizione

Rappresenta un oggetto business che fornisce dati ai controlli con associazione a dati in architetture di applicazioni Web a più livelli.Represents a business object that provides data to data-bound controls in multitier Web application architectures.

public ref class ObjectDataSource : System::Web::UI::DataSourceControl
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl
type ObjectDataSource = class
    inherit DataSourceControl
Public Class ObjectDataSource
Inherits DataSourceControl
Ereditarietà
ObjectDataSource
Attributi

Esempio

Un progetto di sito Web di Visual Studio con codice sorgente è disponibile per accompagnare questo argomento: download.A Visual Studio Web site project with source code is available to accompany this topic: Download.

In questa sezione viene illustrata una ObjectDataSource nel markup in una pagina aspx che Mostra gli oggetti business con cui funziona.This section shows an ObjectDataSource in markup in an .aspx page and it shows the business objects that it works with. L'esempio è la pagina aspx.The example is the .aspx page. Contiene un controllo GridView associato a un controllo ObjectDataSource.It contains a GridView control that is bound to an ObjectDataSource control. Il markup del controllo ObjectDataSource specifica il nome dell'oggetto business e il nome del metodo dell'oggetto business da chiamare per recuperare i dati.The ObjectDataSource control markup specifies the name of the business object and the name of the business object method to call in order to retrieve data.

<%@ 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 controllo ObjectDataSource nella pagina aspx.The following example shows the business object that the ObjectDataSource control in the .aspx page uses. (Molti altri esempi di codice ObjectDataSource usano anche questo oggetto business). L'esempio è costituito dalle due classi di base seguenti:(Many other ObjectDataSource code examples use this business object also.) The example consists of the following two basic classes:

  • La classe EmployeeLogic è la classe della logica di business utilizzata dall'ObjectDataSource.The EmployeeLogic class is the business logic class that the ObjectDataSource uses.

  • La classe NorthwindEmployee definisce l'oggetto dati restituito dal metodo GetAllEmployees della classe EmployeeLogic.The NorthwindEmployee class defines the data object that is returned by the GetAllEmployees method of the EmployeeLogic class.

Per praticità, viene fornita una classe NorthwindDataException aggiuntiva.An additional NorthwindDataException class is provided as a convenience.

Questo set di classi di esempio funziona con il database Northwind Traders, disponibile con Microsoft SQL Server e Microsoft Access.This set of example classes works with the Northwind Traders database, which is available with Microsoft SQL Server and Microsoft Access. Per un esempio di funzionamento completo, è necessario compilare e utilizzare queste classi con l'esempio di pagina. aspx fornito.For a complete working example, you must compile and use these classes with the .aspx page example that is provided.

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 argomentoIn this topic:

IntroduzioneIntroduction

Un controllo ObjectDataSource funziona con una classe creata dall'utente.An ObjectDataSource control works with a class that you create. Si creano metodi che recuperano e aggiornano i dati e si specificano i nomi di tali metodi per il controllo ObjectDataSource nel markup.You create methods that retrieve and update data, and you provide the names of those methods to the ObjectDataSource control in markup. Durante il rendering o l'elaborazione del postback, il ObjectDataSource chiama i metodi specificati.During rendering or postback processing, the ObjectDataSource calls the methods that you have specified.

Nessun rendering visivo del controllo ObjectDataSource.There is no visual rendering of the ObjectDataSource control. Di conseguenza, il ObjectDataSource non supporta le funzionalità visive, ad esempio la proprietà EnableTheming o SkinID.As a result, the ObjectDataSource does not support visual features such as the EnableTheming or SkinID property.

ScopoPurpose

Una procedura di progettazione dell'applicazione molto comune consiste nel separare il livello di presentazione dalla logica di business e incapsulare la logica di business negli oggetti business.A very common application design practice is to separate the presentation layer from business logic and to encapsulate the business logic in business objects. Questi oggetti business formano un livello distinto tra il livello di presentazione e il livello dati, ottenendo un'architettura di applicazione a tre livelli.These business objects form a distinct layer between the presentation layer and the data tier, resulting in a three-tier application architecture. Il controllo ObjectDataSource consente agli sviluppatori di utilizzare un controllo origine dati ASP.NET, mantenendo al tempo stesso l'architettura delle applicazioni a tre livelli.The ObjectDataSource control enables developers to use an ASP.NET data source control while retaining their three-tier application architecture.

Il controllo ObjectDataSource usa la reflection per creare istanze di oggetti business e per chiamare metodi su di essi per recuperare, aggiornare, inserire ed eliminare dati.The ObjectDataSource control uses reflection to create instances of business objects and to call methods on them to retrieve, update, insert, and delete data. La proprietà TypeName identifica il nome della classe con cui funziona il ObjectDataSource.The TypeName property identifies the name of the class that the ObjectDataSource works with. Il controllo ObjectDataSource crea ed Elimina un'istanza della classe per ogni chiamata al metodo. non tiene l'oggetto in memoria per la durata della richiesta Web.The ObjectDataSource control creates and destroys an instance of the class for each method call; it does not hold the object in memory for the lifetime of the Web request. Si tratta di una considerazione grave se l'oggetto business usato richiede molte risorse o è altrimenti costoso da creare ed eliminare definitivamente.This is a serious consideration if the business object that you use requires many resources or is otherwise expensive to create and destroy. L'utilizzo di un oggetto dispendioso potrebbe non essere una scelta ottimale, ma è possibile controllare il ciclo di vita dell'oggetto utilizzando gli eventi ObjectCreating, ObjectCreatede ObjectDisposing.Using an expensive object might not be an optimal design choice, but you can control the life cycle of the object by using the ObjectCreating, ObjectCreated, and ObjectDisposing events.

Nota

I metodi identificati dalle proprietà SelectMethod, UpdateMethod, InsertMethode DeleteMethod possono essere metodi di istanza o static (Shared nei metodi Visual Basic).The methods that are identified by the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod properties can be instance methods or static (Shared in Visual Basic) methods. Se i metodi sono static (Shared in Visual Basic), non viene creata un'istanza dell'oggetto business e gli eventi ObjectCreating, ObjectCreatede ObjectDisposing non vengono generati.If the methods are static (Shared in Visual Basic), an instance of the business object is not created, and the ObjectCreating, ObjectCreated, and ObjectDisposing events are not raised.

Recupero di datiRetrieving Data

Per recuperare dati da un oggetto business, impostare la proprietà SelectMethod sul nome del metodo che recupera i dati.To retrieve data from a business object, set the SelectMethod property to the name of the method that retrieves data. Se il metodo non restituisce un oggetto IEnumerable o DataSet, l'oggetto viene incluso nel runtime in una raccolta di IEnumerable.If the method does not return an IEnumerable or DataSet object, the object is wrapped by the runtime in an IEnumerable collection. Se la firma del metodo dispone di parametri, è possibile aggiungere Parameter oggetti alla raccolta SelectParameters e quindi associarli ai valori che si desidera passare al metodo specificato dalla proprietà SelectMethod.If the method signature has parameters, you can add Parameter objects to the SelectParameters collection, and then bind them to the values that you want to pass to the method that is specified by the SelectMethod property. Affinché il controllo ObjectDataSource utilizzi i parametri, i parametri devono corrispondere ai nomi e ai tipi dei parametri nella firma del metodo.In order for the ObjectDataSource control to use the parameters, the parameters must match the names and types of the parameters in the method signature. Per ulteriori informazioni, vedere utilizzo di parametri con il controllo ObjectDataSource.For more information, see Using Parameters with the ObjectDataSource Control.

Il controllo ObjectDataSource recupera i dati ogni volta che viene chiamato il metodo Select.The ObjectDataSource control retrieves data whenever the Select method is called. Questo metodo fornisce l'accesso programmatico al metodo specificato dalla proprietà SelectMethod.This method provides programmatic access to the method that is specified by SelectMethod property. Il metodo specificato dalla proprietà SelectMethod viene chiamato automaticamente dai controlli associati al ObjectDataSource quando viene chiamato il metodo DataBind.The method that is specified by the SelectMethod property is called automatically by controls that are bound to the ObjectDataSource when their DataBind method is called. Se si imposta la proprietà DataSourceID di un controllo associato a dati, il controllo si associa automaticamente ai dati dell'origine dati, in base alle esigenze.If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as needed. L'impostazione della proprietà DataSourceID è il metodo consigliato per l'associazione di un controllo ObjectDataSource a un controllo con associazione a dati.Setting the DataSourceID property is the recommended method for binding an ObjectDataSource control to a data-bound control. In alternativa, è possibile impostare la proprietà DataSource, ma è necessario chiamare in modo esplicito il metodo di DataBind del controllo associato a dati.Alternatively, you can set the DataSource property, but then you must explicitly call the DataBind method of the data-bound control. È possibile chiamare il metodo Select a livello di codice in qualsiasi momento per recuperare i dati.You can call the Select method programmatically at any time to retrieve data.

Per ulteriori informazioni sull'associazione di controlli associati a dati ai controlli origine dati, vedere binding ai dati mediante un controllo origine dati.For more information about binding data-bound controls to data source controls, see Binding to Data Using a Data Source Control.

Esecuzione di operazioni sui datiPerforming Data Operations

A seconda delle funzionalità dell'oggetto business utilizzato dal controllo ObjectDataSource, è possibile eseguire operazioni sui dati, ad esempio aggiornamenti, inserimenti ed eliminazioni.Depending on the capabilities of the business object that the ObjectDataSource control works with, you can perform data operations, such as updates, insertions, and deletions. Per eseguire queste operazioni sui dati, impostare il nome del metodo appropriato e gli eventuali parametri associati per l'operazione che si desidera eseguire.To perform these data operations, set the appropriate method name and any associated parameters for the operation that you want to perform. Per un'operazione di aggiornamento, ad esempio, impostare la proprietà UpdateMethod sul nome del metodo dell'oggetto business che esegue gli aggiornamenti e aggiungere eventuali parametri obbligatori alla raccolta di UpdateParameters.For example, for an update operation, set the UpdateMethod property to the name of the business object method that performs updates and add any required parameters to the UpdateParameters collection. Se il controllo ObjectDataSource è associato a un controllo con associazione a dati, i parametri vengono aggiunti dal controllo con associazione a dati.If the ObjectDataSource control is associated with a data-bound control, the parameters are added by the data-bound control. In questo caso, è necessario assicurarsi che i nomi di parametro del metodo corrispondano ai nomi dei campi nel controllo con associazione a dati.In this case, you need to ensure that the parameter names of the method match the field names in the data-bound control. L'aggiornamento viene eseguito quando viene chiamato il metodo Update, in modo esplicito dal codice o automaticamente da un controllo con associazione a dati.The update is performed when the Update method is called, either explicitly by your code or automatically by a data-bound control. Lo stesso modello generale viene seguito per le operazioni di Delete e Insert.The same general pattern is followed for Delete and Insert operations. Si presuppone che gli oggetti business eseguano questi tipi di operazioni dati un record alla volta, anziché in batch.Business objects are assumed to perform these types of data operations one record at a time, rather than batched.

Filtro dei datiFiltering Data

Il controllo ObjectDataSource può filtrare i dati recuperati dalla proprietà SelectMethod, se i dati vengono restituiti come oggetto DataSet o DataTable.The ObjectDataSource control can filter data that is retrieved by the SelectMethod property, if the data is returned as a DataSet or DataTable object. È possibile impostare la proprietà FilterExpression su un'espressione di filtro usando una sintassi di stringa di formato e associare valori nell'espressione ai parametri specificati nella raccolta FilterParameters.You can set the FilterExpression property to a filtering expression by using a format string syntax and bind values in the expression to parameters that are specified in the FilterParameters collection.

Memorizzazione nella cacheCaching

Sebbene il ObjectDataSource non mantenga l'istanza dell'oggetto business tra più richieste, può memorizzare nella cache il risultato della chiamata al metodo identificato dalla proprietà SelectMethod.Although the ObjectDataSource does not retain the instance of the business object across multiple requests, it can cache the result of calling the method identified by the SelectMethod property. Mentre i dati vengono memorizzati nella cache, le chiamate successive al metodo Select restituiscono i dati memorizzati nella cache anziché creare l'oggetto business e chiamare il relativo SelectMethod mediante reflection.While the data is cached, subsequent calls to the Select method return the cached data instead of creating the business object and calling its SelectMethod using reflection. La memorizzazione nella cache consente di evitare la creazione dell'oggetto e la chiamata al relativo metodo dati a scapito della memoria sul server Web.Caching lets you avoid creating the object and calling its data method at the expense of memory on the Web server. Il ObjectDataSource memorizza automaticamente nella cache i dati quando la proprietà EnableCaching è impostata su truee la proprietà CacheDuration è impostata sul numero di secondi durante i quali la cache archivia i dati prima che la cache venga eliminata.The ObjectDataSource automatically caches data when the EnableCaching property is set to true, and the CacheDuration property is set to the number of seconds that the cache stores data before the cache is discarded. È inoltre possibile specificare una proprietà CacheExpirationPolicy e una proprietà SqlCacheDependency facoltativa.You can also specify a CacheExpirationPolicy property and an optional SqlCacheDependency property. Il controllo ObjectDataSource consente di memorizzare nella cache tutti i tipi di dati, ma non è consigliabile memorizzare nella cache gli oggetti che conservano le risorse o lo stato che non possono essere condivisi per soddisfare più richieste, ad esempio un oggetto SqlDataReader aperto, perché la stessa istanza dell'oggetto verrà utilizzata per soddisfare più richieste.The ObjectDataSource control allows you to cache all types of data, but you should not cache objects that retain resources or state that cannot be shared to service multiple requests (for example, an open SqlDataReader object), because the same instance of the object will be used to service multiple requests.

FunzionalitàFeatures

Nella tabella seguente vengono descritte le funzionalità del controllo ObjectDataSource.The following table describes the features of the ObjectDataSource control.

FunzionalitàCapability RequisitiRequirements
Selezionare:Selecting Impostare la proprietà SelectMethod sul nome del metodo dell'oggetto business che seleziona i dati e includere tutti i parametri necessari nella raccolta SelectParameters a livello di codice o tramite un controllo con associazione a dati.Set the SelectMethod property to the name of the business object method that selects data, and include any necessary parameters in the SelectParameters collection either programmatically or by using a data-bound control.
OrdinamentoSorting Impostare la proprietà SortParameterName sul nome del parametro nel metodo SelectMethod che contiene i criteri di ordinamento.Set the SortParameterName property to the name of the parameter in the SelectMethod method that carries the sort criteria.
FiltriFiltering Impostare la proprietà FilterExpression su un'espressione di filtro e, facoltativamente, aggiungere eventuali parametri alla raccolta FilterParameters per filtrare i dati quando viene chiamato il metodo Select.Set the FilterExpression property to a filtering expression and optionally add any parameters to the FilterParameters collection to filter the data when the Select method is called. Il metodo specificato dalla proprietà SelectMethod deve restituire una DataSet o DataTable.The method specified by the SelectMethod property must return a DataSet or DataTable.
PagingPaging 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.Data source paging is supported, if the SelectMethod method contains parameters for the maximum number of records to retrieve and the index of the first record to retrieve. I nomi dei parametri devono essere impostati rispettivamente nelle proprietà MaximumRowsParameterName e StartRowIndexParameterName.The names of those parameters must be set in the MaximumRowsParameterName and StartRowIndexParameterName properties, respectively. Un controllo con associazione a dati potrebbe essere in grado di eseguire il paging stesso, anche se il controllo ObjectDataSource non supporta il paging direttamente nel metodo specificato dalla proprietà SelectMethod.A data-bound control might be able to perform paging itself, even if the ObjectDataSource control does not support paging directly in the method specified by the SelectMethod property. Il requisito per consentire al controllo con associazione a dati di eseguire questa operazione è che il metodo specificato dalla proprietà SelectMethod restituisce un oggetto che implementa l'interfaccia ICollection.The requirement for the data-bound control to be able to do this is that the method specified by the SelectMethod property return an object that implements the ICollection interface.
AggiornamentoUpdating Impostare la proprietà UpdateMethod sul nome del metodo dell'oggetto business che aggiorna i dati e includere tutti i parametri necessari nella raccolta di UpdateParameters.Set the UpdateMethod property to the name of the business object method that updates data, and include any necessary parameters in the UpdateParameters collection.
DeletingDeleting Impostare la proprietà DeleteMethod sul nome del metodo o della funzione dell'oggetto business che elimina i dati e includere tutti i parametri necessari nella raccolta di DeleteParameters.Set the DeleteMethod property to the name of the business object method or function that deletes data, and include any necessary parameters in the DeleteParameters collection.
InserimentoInserting Impostare la proprietà InsertMethod sul nome del metodo o della funzione dell'oggetto business che inserisce i dati e includere tutti i parametri necessari nella raccolta di InsertParameters.Set the InsertMethod property to the name of the business object method or function that inserts data, and include any necessary parameters in the InsertParameters collection.
Memorizzazione nella cacheCaching Impostare la proprietà EnableCaching su truee le proprietà CacheDuration e CacheExpirationPolicy in base al comportamento di memorizzazione nella cache desiderato per i dati memorizzati nella cache.Set the EnableCaching property to true, and the CacheDuration and CacheExpirationPolicy properties according to the caching behavior you want for your cached data.

Nota

Quando si utilizza la classe ObjectDataSource per aggiornare o inserire dati, le stringhe immesse nel client non vengono automaticamente convertite dal formato delle impostazioni cultura del client al formato delle impostazioni cultura del server.When you use the ObjectDataSource class to update or insert data, strings that are entered at the client are not automatically converted from the client culture format to the server culture format. Ad esempio, le impostazioni cultura client possono specificare GG/MM/AAAA come formato della data e il formato della data sul server potrebbe essere MM/gg/aaaa.For example, the client culture might specify DD/MM/YYYY as the date format, and the date format on the server might be MM/DD/YYYY. In tal caso, il 5 ottobre 2009 verrebbe immesso in un controllo TextBox come 5/10/2009 ma verrebbe interpretato come il 10 maggio 2009.In that case, October 5, 2009 would be entered in a TextBox control as 5/10/2009 but would be interpreted as May 10, 2009. Il 15 ottobre 2009 verrebbe immesso come 15/10/2009 e verrebbe rifiutato come data non valida.October 15, 2009 would be entered as 15/10/2009, and would be rejected as an invalid date.

Vista datiData View

Come per tutti i controlli origine dati, il controllo ObjectDataSource è associato a una classe della vista origine dati.As with all data source controls, the ObjectDataSource control is associated with a data source view class. Sebbene il controllo ObjectDataSource sia l'interfaccia usata dallo sviluppatore della pagina per lavorare con i dati, la classe ObjectDataSourceView è l'interfaccia a cui funzionano i controlli con associazione a dati.While the ObjectDataSource control is the interface that the page developer uses to work with data, the ObjectDataSourceView class is the interface that data-bound controls work with. Inoltre, la classe ObjectDataSourceView descrive le funzionalità del controllo origine dati ed esegue il lavoro effettivo.Additionally, the ObjectDataSourceView class describes the capabilities of the data source control, and performs the actual work. Al controllo ObjectDataSource è associato un solo ObjectDataSourceViewed è sempre denominato DefaultView.The ObjectDataSource control has only one associated ObjectDataSourceView, and it is always named DefaultView. Mentre l'oggetto ObjectDataSourceView viene esposto dal metodo GetView, molte proprietà e metodi vengono sottoposti a incapsulamento ed esposti direttamente dal controllo ObjectDataSource.While the ObjectDataSourceView object is exposed by the GetView method, many of its properties and methods are wrapped and exposed directly by the ObjectDataSource control. Dietro le quinte, l'oggetto ObjectDataSourceView esegue tutte le operazioni sui dati, inclusi il recupero, l'inserimento, l'aggiornamento, l'eliminazione, l'applicazione di filtri e l'ordinamento dei dati.Behind the scenes, the ObjectDataSourceView object performs all data operations, including retrieving, inserting, updating, deleting, filtering, and sorting the data. Per altre informazioni, vedere ObjectDataSourceView.For more information, see ObjectDataSourceView.

Utilizzo di LINQ to SQLUsing LINQ to SQL

È possibile utilizzare il controllo ObjectDataSource con una classe LINQ to SQL.You can use the ObjectDataSource control with a LINQ to SQL class. A tale scopo, impostare la proprietà TypeName sul nome della classe del contesto dati.To do so, you set the TypeName property to the name of the data-context class. È inoltre possibile impostare i metodi SelectMethod, UpdateMethod, InsertMethode DeleteMethod sui metodi della classe del contesto dati che eseguono le operazioni corrispondenti.You also set the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod methods to the methods in the data-context class that perform the corresponding operations. È necessario creare un gestore eventi per l'evento ObjectDisposing per annullare l'eliminazione della classe del contesto dati.You must create an event handler for the ObjectDisposing event in order to cancel disposing of the data-context class. Questo passaggio è necessario perché LINQ to SQL supporta l'esecuzione posticipata, mentre il controllo ObjectDataSource tenta di eliminare il contesto dati dopo l'operazione di selezione.This step is necessary because LINQ to SQL supports deferred execution, whereas the ObjectDataSource control tries to dispose the data context after the Select operation. Per altre informazioni su come creare classi di LINQ to SQL, vedere procedura: creare LINQ to SQL classi in un progetto Web.For more information about how to create LINQ to SQL classes, see How to: Create LINQ to SQL Classes in a Web Project. Per un esempio di annullamento dell'eliminazione di una classe del contesto dati, vedere l'evento ObjectDisposing.For an example of how to cancel the disposing of a data context class, see the ObjectDisposing event.

Uso della Entity FrameworkUsing the Entity Framework

È anche possibile usare il controllo ObjectDataSource con il Entity Framework.You can also use the ObjectDataSource control with the Entity Framework. Per ulteriori informazioni, vedere utilizzo del Entity Framework e del controllo ObjectDataSource.For more information, see Using the Entity Framework and the ObjectDataSource Control.

Sintassi dichiarativaDeclarative Syntax

<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.Initializes a new instance of the ObjectDataSource class.

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.Initializes a new instance of the ObjectDataSource class with the specified type name and data retrieval method name.

Proprietà

Adapter

Ottiene l'adattatore specifico del browser per il controllo.Gets the browser-specific adapter for the control.

(Ereditato da Control)
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Ereditato da Control)
BindingContainer

Ottiene il controllo contenente l'associazione dati del controllo corrente.Gets the control that contains this control's data binding.

(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.Gets or sets the length of time, in seconds, that the data source control caches data that is retrieved by the SelectMethod property.

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.Gets or sets the cache expiration behavior that, when combined with the duration, describes the behavior of the cache that the data source control uses.

CacheKeyDependency

Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti cache dati creati dal controllo origine dati.Gets or sets a user-defined key dependency that is linked to all data cache objects that are created by the data source control.

ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.Gets a value that indicates whether the server control's child controls have been created.

(Ereditato da Control)
ClientID

Ottiene l'identificatore del controllo server generato da ASP.NET.Gets the server control identifier generated by ASP.NET.

(Ereditato da DataSourceControl)
ClientIDMode

Questa proprietà non viene utilizzata per i controlli origine dati.This property is not used for data source controls.

(Ereditato da DataSourceControl)
ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.Gets a character value representing the separator character used in the ClientID property.

(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.Gets or sets a value that determines whether or not just the new values are passed to the Update method or both the old and new values are passed to the Update method.

Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.Gets the HttpContext object associated with the server control for the current Web request.

(Ereditato da Control)
Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(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.Gets or sets a value indicating whether the Parameter values that are passed to an update, insert, or delete operation are automatically converted from null to the Value value by the ObjectDataSource control.

DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements 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.Gets or sets the name of a class that the ObjectDataSource control uses for a parameter in an update, insert, or delete data operation, instead of passing individual values from the data-bound control.

DeleteMethod

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per eliminare dati.Gets or sets the name of the method or function that the ObjectDataSource control invokes to delete data.

DeleteParameters

Ottiene l'insieme di parametri contenente i parametri utilizzati dal metodo DeleteMethod.Gets the parameters collection that contains the parameters that are used by the DeleteMethod method.

DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.Gets a value indicating whether a control is being used on a design surface.

(Ereditato da Control)
EnableCaching

Ottiene o imposta un valore indicante se la memorizzazione di dati nella cache è abilitata nel controllo ObjectDataSource.Gets or sets a value indicating whether the ObjectDataSource control has data caching enabled.

EnablePaging

Ottiene o imposta un valore indicante se il controllo origine dati supporta il paging dell'insieme di dati recuperati.Gets or sets a value that indicates whether the data source control supports paging through the set of data that it retrieves.

EnableTheming

Ottiene un valore che indica se il controllo supporta i temi.Gets a value indicating whether this control supports themes.

(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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Ereditato da Control)
Events

Ottiene un elenco dei delegati del gestore eventi per il controllo.Gets a list of event handler delegates for the control. Questa proprietà è di sola lettura.This property is read-only.

(Ereditato da Control)
FilterExpression

Ottiene o imposta un'espressione di filtro applicata quando il metodo specificato dalla proprietà SelectMethod viene chiamato.Gets or sets a filtering expression that is applied when the method that is specified by the SelectMethod property is called.

FilterParameters

Ottiene un insieme di parametri associati ai segnaposto di parametro nella stringa FilterExpression.Gets a collection of parameters that are associated with any parameter placeholders in the FilterExpression string.

HasChildViewState

Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Ereditato da Control)
ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.Gets or sets the programmatic identifier assigned to the server control.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.Gets the character used to separate control identifiers.

(Ereditato da Control)
InsertMethod

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per inserire dati.Gets or sets the name of the method or function that the ObjectDataSource control invokes to insert data.

InsertParameters

Ottiene l'insieme di parametri contenente i parametri utilizzati dalla proprietà InsertMethod.Gets the parameters collection that contains the parameters that are used by the InsertMethod property.

IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.Gets a value indicating whether controls contained within this control have control state.

(Ereditato da Control)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.Gets a value that indicates whether the server control is saving changes to its view state.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.Gets a value indicating whether view state is enabled for this control.

(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.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(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.Gets or sets the name of the business object data retrieval method parameter that is used to indicate the number of records to retrieve for data source paging support.

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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(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.Gets or sets a format string to apply to the names of the parameters for original values that are passed to the Delete or Update methods.

Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.Gets a reference to the Page instance that contains the server control.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.Gets a reference to the server control's parent control in the page control hierarchy.

(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.Gets a or sets a value that indicates what culture information is used when converting string values to actual property types in order to construct an object of the type indicated by 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.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Ereditato da Control)
SelectCountMethod

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per recuperare un numero di righe.Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve a row count.

SelectMethod

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per recuperare i dati.Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve data.

SelectParameters

Ottiene un insieme di parametri utilizzati dal metodo specificato dalla proprietà SelectMethod.Gets a collection of parameters that are used by the method specified by the SelectMethod property.

Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.Gets information about the container that hosts the current control when rendered on a design surface.

(Ereditato da Control)
SkinID

Ottiene l'interfaccia da applicare al controllo DataSourceControl.Gets the skin to apply to the DataSourceControl control.

(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.Gets or sets the name of the business object that the SelectMethod parameter used to specify a sort expression for data source sorting support.

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.Gets or sets a semicolon-delimited string that indicates which databases and tables to use for the Microsoft SQL Server cache dependency.

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.Gets or sets the name of the data retrieval method parameter that is used to indicate the value of the identifier of the first record to retrieve for data source paging support.

TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.Gets or sets a reference to the template that contains this control.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Ereditato da Control)
TypeName

Ottiene o imposta il nome della classe rappresentata dall'oggetto ObjectDataSource.Gets or sets the name of the class that the ObjectDataSource object represents.

UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.Gets the unique, hierarchically qualified identifier for the server control.

(Ereditato da Control)
UpdateMethod

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSource richiama per aggiornare i dati.Gets or sets the name of the method or function that the ObjectDataSource control invokes to update data.

UpdateParameters

Ottiene l'insieme di parametri contenente i parametri utilizzati dal metodo specificato dalla proprietà UpdateMethod.Gets the parameters collection that contains the parameters that are used by the method that is specified by the UpdateMethod property.

ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.Gets a value that indicates whether the StateBag object is case-insensitive.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.Gets or sets the view-state mode of this control.

(Ereditato da Control)
Visible

Ottiene o imposta un valore che indica se il controllo è visualizzato.Gets or sets a value indicating whether the control is visually displayed.

(Ereditato da DataSourceControl)

Metodi

AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control.Called after a child control is added to the Controls collection of the Control object.

(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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Ereditato da Control)
ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.Applies the style properties that are defined in the page style sheet to the control.

(Ereditato da DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.Begins design-time tracing of rendering data.

(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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID su null.Sets the cached ClientID value to null.

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.Deletes the control-state information for the server control's child controls.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.Deletes the view-state and control-state information for all the server control's child controls.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.Deletes the view-state information for all the server control's child controls.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to 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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Ereditato da Control)
CreateControlCollection()

Crea una raccolta per l'archiviazione di controlli figlio.Creates a collection to store child controls.

(Ereditato da DataSourceControl)
DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.Binds a data source to the invoked server control and all its child controls.

(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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.Binds a data source to the server control's child controls.

(Ereditato da Control)
Delete()

Esegue un'operazione di eliminazione chiamando il metodo identificato dalla proprietà DeleteMethod con i parametri contenuti nell'insieme DeleteParameters.Performs a delete operation by calling the method that is identified by the DeleteMethod property with any parameters that are in the DeleteParameters collection.

Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria.Enables a server control to perform final clean up before it is released from memory.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.Ends design-time tracing of rendering data.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio.Determines whether the server control contains child controls. In caso contrario, li crea.If it does not, it creates child controls.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.Creates an identifier for controls that do not have an identifier assigned.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.Searches the current naming container for a server control with the specified id parameter.

(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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Non eseguire l'override di questa versione del metodo FindControl.You should not override this version of the FindControl method.

(Ereditato da Control)
Focus()

Imposta lo stato attivo per l'input del controllo.Sets input focus to the control.

(Ereditato da DataSourceControl)
GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.Gets design-time data for a control.

(Ereditato da Control)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetRouteUrl(Object)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato.Returns the prefixed portion of the UniqueID property of the specified control.

(Ereditato da Control)
GetView(String)

Recupera la visualizzazione origine dati denominata associata al controllo origine dati.Retrieves the named data source view that is associated with the data source control.

GetViewNames()

Recupera un insieme di nomi che rappresentano l'elenco di oggetti visualizzazione associati all'oggetto ObjectDataSource.Retrieves a collection of names representing the list of view objects that are associated with the ObjectDataSource object.

HasControls()

Determina se il controllo server contiene controlli figlio.Determines if the server control contains any child controls.

(Ereditato da DataSourceControl)
HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.Returns a value indicating whether events are registered for the control or any child controls.

(Ereditato da Control)
Insert()

Esegue un'operazione di inserimento chiamando il metodo identificato dalla proprietà InsertMethod e dai parametri nell'insieme InsertParameters.Performs an insert operation by calling the method that is identified by the InsertMethod property and any parameters in the InsertParameters collection.

IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.Determines if the server control holds only literal content.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Ereditato da Control)
LoadViewState(Object)

Carica lo stato di visualizzazione precedentemente salvato del controllo ObjectDataSource.Loads the previously saved view state of the ObjectDataSource control.

MapPathSecure(String)

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Ereditato da Control)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Ereditato da Control)
OnInit(EventArgs)

Aggiunge un gestore eventi LoadComplete alla pagina che contiene il controllo ObjectDataSource.Adds a LoadComplete event handler to the page that contains the ObjectDataSource control.

OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

(Ereditato da Control)
OnUnload(EventArgs)

Genera l'evento Unload.Raises the Unload event.

(Ereditato da Control)
OpenFile(String)

Ottiene un oggetto Stream utilizzato per leggere un file.Gets a Stream used to read a file.

(Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.Assigns any sources of the event and its information to the control's parent.

(Ereditato da Control)
RaiseDataSourceChangedEvent(EventArgs)

Genera l'evento DataSourceChanged.Raises the DataSourceChanged event.

(Ereditato da DataSourceControl)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.Called after a child control is removed from the Controls collection of the Control object.

(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.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the 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.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the 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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Ereditato da DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Ereditato da Control)
ResolveAdapter()

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.Gets the control adapter responsible for rendering the specified control.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.Gets a URL that can be used by the browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.Converts a URL into one that is usable on the requesting client.

(Ereditato da Control)
SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Ereditato da Control)
SaveViewState()

Salva lo stato del controllo ObjectDataSource.Saves the state of the ObjectDataSource control.

Select()

Recupera i dati dall'archivio dati sottostante chiamando il metodo identificato dalla proprietà SelectMethod con i parametri nell'insieme SelectParameters.Retrieves data from the underlying data storage by calling the method that is identified by the SelectMethod property with the parameters in the SelectParameters collection.

SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.Sets design-time data for a control.

(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.Assigns an event handler delegate to render the server control and its content into its parent control.

(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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(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.Tracks view-state changes to the ObjectDataSource control so that they can be stored in the StateBag object.

Update()

Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla proprietà UpdateMethod e dai parametri contenuti nell'insieme UpdateParameters.Performs an update operation by calling the method that is identified by the UpdateMethod property and any parameters that are in the UpdateParameters collection.

Eventi

DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.Occurs when the server control binds to a data source.

(Ereditato da Control)
Deleted

Si verifica quando viene completata un'operazione Delete().Occurs when a Delete() operation has completed.

Deleting

Si verifica prima di un'operazione Delete().Occurs before a Delete() operation.

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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Ereditato da Control)
Filtering

Si verifica prima di un'operazione di filtro.Occurs before a filter operation.

Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Ereditato da Control)
Inserted

Si verifica quando viene completata un'operazione Insert().Occurs when an Insert() operation has completed.

Inserting

Si verifica prima di un'operazione Insert().Occurs before an Insert() operation.

Load

Viene generato quando il controllo server è caricato nell'oggetto Page.Occurs when the server control is loaded into the Page object.

(Ereditato da Control)
ObjectCreated

Si verifica dopo la creazione dell'oggetto identificato dalla proprietà TypeName.Occurs after the object that is identified by the TypeName property is created.

ObjectCreating

Si verifica prima della creazione dell'oggetto identificato dalla proprietà TypeName.Occurs before the object that is identified by the TypeName property is created.

ObjectDisposing

Si verifica prima dell'eliminazione dell'oggetto identificato dalla proprietà TypeName.Occurs before the object that is identified by the TypeName property is discarded.

PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.Occurs after the Control object is loaded but prior to rendering.

(Ereditato da Control)
Selected

Si verifica quando viene completata un'operazione Select().Occurs when a Select() operation has completed.

Selecting

Si verifica prima di un'operazione Select().Occurs before a Select() operation.

Unload

Viene generato quando il controllo server viene scaricato dalla memoria.Occurs when the server control is unloaded from memory.

(Ereditato da Control)
Updated

Si verifica quando viene completata un'operazione Update().Occurs when an Update() operation has completed.

Updating

Si verifica prima di un'operazione Update().Occurs before an Update() operation.

Implementazioni dell'interfaccia esplicita

IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.For a description of this member, see ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().For a description of this member, see GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.For a description of this member, see UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.For a description of this member, see DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.For a description of this member, see 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.Occurs when a data source control has changed in a way that affects data-bound controls.

(Ereditato da DataSourceControl)
IDataSource.GetView(String)

Ottiene l'oggetto DataSourceView denominato associato al controllo DataSourceControl.Gets the named DataSourceView object associated with the DataSourceControl control. Alcuni controlli origine dati supportano una sola visualizzazione, mentre altri ne supportano più di una.Some data source controls support only one view, while others support more than one.

(Ereditato da DataSourceControl)
IDataSource.GetViewNames()

Ottiene un insieme di nomi che rappresentano l'elenco di oggetti DataSourceView associati al controllo DataSourceControl.Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control.

(Ereditato da DataSourceControl)
IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.For a description of this member, see Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.For a description of this member, see HasExpressions.

(Ereditato da Control)
IListSource.ContainsListCollection

Indica se il controllo origine dati è associato a uno o più elenchi di dati.Indicates whether the data source control is associated with one or more lists of data.

(Ereditato da DataSourceControl)
IListSource.GetList()

Ottiene un elenco di controlli origine dati che possono essere utilizzati come origini degli elenchi di dati.Gets a list of data source controls that can be used as sources of lists of data.

(Ereditato da DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Ereditato da Control)

Metodi di estensione

FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Restituisce l'oggetto metatabella per il controllo contenitore dei dati.Returns the metatable object for the containing data control.

GetDefaultValues(IDataSource)

Ottiene l'insieme di valori predefiniti per l'origine dati specificata.Gets the collection of the default values for the specified data source.

GetMetaTable(IDataSource)

Ottiene i metadati per una tabella nell'oggetto origine dati specificato.Gets the metadata for a table in the specified data source object.

TryGetMetaTable(IDataSource, MetaTable)

Determina se sono disponibili i metadati della tabella.Determines whether table metadata is available.

Si applica a

Vedi anche