ObjectDataSource ObjectDataSource ObjectDataSource ObjectDataSource Class

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à
Attributi

Esempi

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

In questa sezione viene ObjectDataSource illustrato un markup in una pagina con estensione 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 GridView controllo associato a un ObjectDataSource controllo.It contains a GridView control that is bound to an ObjectDataSource control. Il ObjectDataSource markup del controllo specifica il nome dell'oggetto business e il nome del metodo dell'oggetto business da chiamare per recuperare i dati.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 ObjectDataSource dal controllo nella pagina aspx.The following example shows the business object that the ObjectDataSource control in the .aspx page uses. (Molti altri ObjectDataSource esempi di codice 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 EmployeeLogic classe è la classe della logica di business ObjectDataSource utilizzata dall'oggetto.The EmployeeLogic class is the business logic class that the ObjectDataSource uses.

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

Viene fornita NorthwindDataException una classe aggiuntiva per praticità.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. Per informazioni su come installare il database Northwind Traders, vedere procedura: Installare i databasedi esempio.For information about how to install the Northwind Traders database, see How to: Install Sample Databases.

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 ObjectDataSource controllo 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 ObjectDataSource metodi per il controllo 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 ObjectDataSource postback, chiama i metodi specificati.During rendering or postback processing, the ObjectDataSource calls the methods that you have specified.

Nessun rendering visivo del ObjectDataSource controllo.There is no visual rendering of the ObjectDataSource control. Di conseguenza, non supporta ObjectDataSource le funzionalità visive, ad esempio la EnableTheming proprietà SkinID o.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 ObjectDataSource controllo consente agli sviluppatori di utilizzare un controllo origine dati ASP.NET mantenendo la relativa architettura di applicazione a tre livelli.The ObjectDataSource control enables developers to use an ASP.NET data source control while retaining their three-tier application architecture.

Il ObjectDataSource controllo Usa la reflection per creare istanze di oggetti business e per chiamare metodi su di essi per recuperare, aggiornare, inserire ed eliminare i 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 TypeName proprietà identifica il nome della classe con ObjectDataSource cui funziona.The TypeName property identifies the name of the class that the ObjectDataSource works with. Il ObjectDataSource controllo Crea ed Elimina un'istanza della classe per ogni chiamata al metodo, ma 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 ObjectCreatingutilizzando ObjectCreatedgli eventi ObjectDisposing , e.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

SelectMethodI metodi identificati dalle proprietà, UpdateMethod, InsertMethode DeleteMethod possono essere metodi di istanza o static (Shared in 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 non vengono generati ObjectCreatinggli ObjectCreatedeventi, ObjectDisposing e.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 dei datiRetrieving Data

Per recuperare dati da un oggetto business, impostare la SelectMethod proprietà 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 IEnumerable oggetto o DataSet , l'oggetto viene incapsulato dal runtime in una IEnumerable raccolta.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, è Parameter possibile aggiungere oggetti SelectParameters alla raccolta e quindi associarli ai valori che si desidera passare al metodo specificato dalla SelectMethod proprietà.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 ObjectDataSource controllo 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 ObjectDataSource controllo Recupera i dati ogni Select volta che viene chiamato il metodo.The ObjectDataSource control retrieves data whenever the Select method is called. Questo metodo fornisce l'accesso programmatico al metodo specificato dalla SelectMethod proprietà.This method provides programmatic access to the method that is specified by SelectMethod property. Il metodo specificato dalla SelectMethod proprietà viene chiamato automaticamente dai controlli associati ObjectDataSource a quando DataBind viene chiamato il metodo.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 DataSourceID proprietà 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 DataSourceID della proprietà è il metodo consigliato per l' ObjectDataSource associazione di un controllo 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 DataSource proprietà, ma è necessario chiamare in modo esplicito DataBind il metodo 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 Select metodo 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 con cui funziona il ObjectDataSource controllo, è 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 UpdateMethod la proprietà sul nome del metodo dell'oggetto business che esegue gli aggiornamenti e aggiungere eventuali parametri richiesti UpdateParameters alla raccolta.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 ObjectDataSource controllo è 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 Update chiamato il metodo, 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 Delete le Insert operazioni e.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.

Filtraggio dei datiFiltering Data

Il ObjectDataSource controllo consente SelectMethod di filtrare i dati recuperati dalla proprietà, se i DataSet dati vengono restituiti come oggetto 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 FilterExpression proprietà su un'espressione di filtro usando una sintassi di stringa di formato e associare valori nell'espressione ai parametri specificati FilterParameters nella raccolta.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

Anche se non mantiene l'istanza dell'oggetto business tra più richieste, può memorizzare nella cache il risultato della chiamata al metodo identificato SelectMethod dalla proprietà. ObjectDataSourceAlthough 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 Select successive al metodo restituiscono i dati memorizzati nella cache anziché creare l'oggetto SelectMethod business e chiamando il relativo oggetto utilizzando la 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. I ObjectDataSource dati vengono automaticamente memorizzati nella cache EnableCaching quando la proprietà è trueimpostata su e CacheDuration la proprietà viene 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 CacheExpirationPolicy proprietà e una proprietà SqlCacheDependency facoltativa.You can also specify a CacheExpirationPolicy property and an optional SqlCacheDependency property. Il ObjectDataSource controllo 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 SqlDataReader soddisfare più richieste, ad esempio un oggetto aperto, perché la stessa istanza dell'oggetto verrà usato 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 ObjectDataSource controllo.The following table describes the features of the ObjectDataSource control.

FunzionalitàCapability RequisitiRequirements
SelezioneSelecting Impostare la SelectMethod proprietà sul nome del metodo dell'oggetto business che seleziona i dati e includere tutti i parametri necessari SelectParameters nella raccolta 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 SortParameterName proprietà sul nome del parametro SelectMethod nel metodo 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.
FiltroFiltering Impostare la FilterExpression proprietà su un'espressione di filtro e, facoltativamente, aggiungere eventuali FilterParameters parametri alla raccolta per filtrare i dati Select quando viene chiamato il metodo.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 SelectMethod proprietà deve restituire un oggetto DataSet o. DataTableThe method specified by the SelectMethod property must return a DataSet or DataTable.
PagingPaging Il paging dell'origine dati è supportato se SelectMethod il 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 MaximumRowsParameterName proprietà e. StartRowIndexParameterNameThe 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, ObjectDataSource anche se il controllo non supporta il paging direttamente nel metodo specificato SelectMethod dalla proprietà.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 SelectMethod proprietà restituisce un oggetto che implementa l' ICollection interfaccia.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.
UpdatingUpdating Impostare la UpdateMethod proprietà sul nome del metodo dell'oggetto business che aggiorna i dati e includere tutti i UpdateParameters parametri necessari nella raccolta.Set the UpdateMethod property to the name of the business object method that updates data, and include any necessary parameters in the UpdateParameters collection.
EliminazioneDeleting Impostare la DeleteMethod proprietà sul nome del metodo o della funzione dell'oggetto business che elimina i dati e includere tutti i parametri necessari DeleteParameters nella raccolta.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 InsertMethod proprietà sul nome del metodo o della funzione dell'oggetto business che inserisce i dati e include tutti i parametri necessari InsertParameters nella raccolta.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 EnableCaching proprietà su truee le CacheDuration proprietà 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 ObjectDataSource classe 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 TextBox controllo 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.

Visualizzazione datiData View

Come per tutti i controlli origine dati, ObjectDataSource il controllo è 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 ObjectDataSource controllo sia l'interfaccia usata dallo sviluppatore della pagina per lavorare con i dati, ObjectDataSourceView la classe è l'interfaccia con 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 ObjectDataSourceView classe 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 ObjectDataSource controllo è associato un solo ObjectDataSourceViewoggetto ed è sempre denominato DefaultView.The ObjectDataSource control has only one associated ObjectDataSourceView, and it is always named DefaultView. Mentre l' ObjectDataSourceView oggetto viene esposto GetView dal metodo, molti dei relativi metodi e proprietà vengono racchiusi ObjectDataSource ed esposti direttamente dal controllo.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, ObjectDataSourceView l'oggetto 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 ulteriori informazioni, vedere ObjectDataSourceView.For more information, see ObjectDataSourceView.

Utilizzo di LINQ to SQLUsing LINQ to SQL

È possibile utilizzare il ObjectDataSource controllo con una classe LINQ to SQL.You can use the ObjectDataSource control with a LINQ to SQL class. A tale scopo, impostare la TypeName proprietà 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 SelectMethodi UpdateMethodmetodi InsertMethod,, DeleteMethod e 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. Per annullare l'eliminazione della classe del contesto ObjectDisposing dati, è necessario creare un gestore eventi per l'evento.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 ObjectDataSource controllo 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 ulteriori informazioni su come creare LINQ to SQL classi, vedere procedura: Creare LINQ to SQL classi in un progettoWeb.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' ObjectDisposing evento.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 ObjectDataSource controllo con la 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() ObjectDataSource() ObjectDataSource() ObjectDataSource()

Inizializza una nuova istanza della classe ObjectDataSource.Initializes a new instance of the ObjectDataSource class.

ObjectDataSource(String, String) ObjectDataSource(String, String) ObjectDataSource(String, String) 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 Adapter Adapter Adapter

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

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory 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.

(Inherited from Control)
BindingContainer BindingContainer BindingContainer BindingContainer

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

(Inherited from Control)
CacheDuration CacheDuration CacheDuration 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 CacheExpirationPolicy CacheExpirationPolicy 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 CacheKeyDependency CacheKeyDependency 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 ChildControlsCreated ChildControlsCreated 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.

(Inherited from Control)
ClientID ClientID ClientID ClientID

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

(Inherited from DataSourceControl)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

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

(Inherited from DataSourceControl)
ClientIDSeparator ClientIDSeparator ClientIDSeparator 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.

(Inherited from Control)
ConflictDetection ConflictDetection ConflictDetection 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 Context Context 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.

(Inherited from Control)
Controls Controls Controls 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.

(Inherited from DataSourceControl)
ConvertNullToDBNull ConvertNullToDBNull ConvertNullToDBNull 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 DataItemContainer DataItemContainer 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.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer 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.

(Inherited from Control)
DataObjectTypeName DataObjectTypeName DataObjectTypeName 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 DeleteMethod DeleteMethod 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 DeleteParameters DeleteParameters 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 DesignMode DesignMode 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.

(Inherited from Control)
EnableCaching EnableCaching EnableCaching 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 EnablePaging EnablePaging 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 EnableTheming EnableTheming EnableTheming

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

(Inherited from DataSourceControl)
EnableViewState EnableViewState EnableViewState 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.

(Inherited from Control)
Events Events Events 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.

(Inherited from Control)
FilterExpression FilterExpression FilterExpression 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 FilterParameters FilterParameters 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 HasChildViewState HasChildViewState 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.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

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

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

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

(Inherited from Control)
ID ID ID 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.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

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

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

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

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

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

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

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

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

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

(Inherited from Control)
IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection 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.

(Inherited from DataSourceControl)
InsertMethod InsertMethod InsertMethod 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 InsertParameters InsertParameters 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 IsChildControlStateCleared IsChildControlStateCleared 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.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled 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.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID 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.

(Inherited from Control)
MaximumRowsParameterName MaximumRowsParameterName MaximumRowsParameterName 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 NamingContainer NamingContainer 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.

(Inherited from Control)
OldValuesParameterFormatString OldValuesParameterFormatString OldValuesParameterFormatString 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 Page Page Page

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

(Inherited from Control)
Parent Parent Parent 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.

(Inherited from Control)
ParsingCulture ParsingCulture ParsingCulture 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 RenderingCompatibility RenderingCompatibility 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.

(Inherited from Control)
SelectCountMethod SelectCountMethod SelectCountMethod 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 SelectMethod SelectMethod 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 SelectParameters SelectParameters 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 Site Site 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.

(Inherited from Control)
SkinID SkinID SkinID SkinID

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

(Inherited from DataSourceControl)
SortParameterName SortParameterName SortParameterName 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 SqlCacheDependency SqlCacheDependency 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 StartRowIndexParameterName StartRowIndexParameterName 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 TemplateControl TemplateControl TemplateControl

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

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory 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.

(Inherited from Control)
TypeName TypeName TypeName 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 UniqueID UniqueID UniqueID

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

(Inherited from Control)
UpdateMethod UpdateMethod UpdateMethod 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 UpdateParameters UpdateParameters 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 ValidateRequestMode ValidateRequestMode 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.

(Inherited from Control)
ViewState ViewState ViewState 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.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase 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.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

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

(Inherited from Control)
Visible Visible Visible Visible

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

(Inherited from DataSourceControl)

Metodi

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) 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.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) 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.

(Inherited from Control)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) 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.

(Inherited from DataSourceControl)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

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

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) 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.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

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

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() 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.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() 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.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() 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.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() 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.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() 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.

(Inherited from Control)
CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

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

(Inherited from DataSourceControl)
DataBind() DataBind() DataBind() DataBind()

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

(Inherited from Control)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) 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.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

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

(Inherited from Control)
Delete() Delete() Delete() 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() Dispose() Dispose() 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.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

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

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() 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.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() 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.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) 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.

(Inherited from DataSourceControl)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) 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.

(Inherited from Control)
Focus() Focus() Focus() Focus()

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

(Inherited from DataSourceControl)
GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

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

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(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.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

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

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) 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.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) 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.

(Inherited from Control)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) 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.

(Inherited from Control)
GetView(String) GetView(String) GetView(String) 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() GetViewNames() GetViewNames() 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() HasControls() HasControls() HasControls()

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

(Inherited from DataSourceControl)
HasEvents() HasEvents() HasEvents() 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.

(Inherited from Control)
Insert() Insert() Insert() 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() IsLiteralContent() IsLiteralContent() IsLiteralContent()

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

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) 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.

(Inherited from Control)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

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

MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) 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.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) 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.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) 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) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

(Inherited from Control)
OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Genera l'evento Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

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

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) 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.

(Inherited from Control)
RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs)

Genera l'evento DataSourceChanged.Raises the DataSourceChanged event.

(Inherited from DataSourceControl)
RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) 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.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) 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.

(Inherited from Control)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul 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.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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.

(Inherited from DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) 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.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

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

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

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

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

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

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() 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.

(Inherited from Control)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

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

Select() Select() Select() 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) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

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

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) 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.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) 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.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) 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.

(Inherited from Control)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() 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() Update() Update() 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 DataBinding DataBinding DataBinding

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

(Inherited from Control)
Deleted Deleted Deleted Deleted

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

Deleting Deleting Deleting Deleting

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

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

(Inherited from Control)
Filtering Filtering Filtering Filtering

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

IDataSource.DataSourceChanged IDataSource.DataSourceChanged IDataSource.DataSourceChanged 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.

(Inherited from DataSourceControl)
Init Init Init 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.

(Inherited from Control)
Inserted Inserted Inserted Inserted

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

Inserting Inserting Inserting Inserting

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

Load Load Load Load

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

(Inherited from Control)
ObjectCreated ObjectCreated ObjectCreated 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 ObjectCreating ObjectCreating 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 ObjectDisposing ObjectDisposing 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 PreRender PreRender PreRender

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

(Inherited from Control)
Selected Selected Selected Selected

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

Selecting Selecting Selecting Selecting

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

Unload Unload Unload Unload

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

(Inherited from Control)
Updated Updated Updated Updated

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

Updating Updating Updating Updating

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

Implementazioni dell'interfaccia esplicita

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

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

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

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

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

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

(Inherited from Control)
IDataSource.GetView(String) IDataSource.GetView(String) IDataSource.GetView(String) 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.

(Inherited from DataSourceControl)
IDataSource.GetViewNames() IDataSource.GetViewNames() IDataSource.GetViewNames() 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.

(Inherited from DataSourceControl)
IListSource.GetList() IListSource.GetList() IListSource.GetList() 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.

(Inherited from DataSourceControl)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

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

(Inherited from Control)

Metodi di estensione

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) 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) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) 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) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

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

GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) 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) GetMetaTable(IDataSource) GetMetaTable(IDataSource) 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) TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable)

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

Si applica a

Vedi anche