ObjectDataSource Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um objeto comercial que fornece dados a controles com associação de dados em arquiteturas de aplicativo Web multicamadas.

public ref class ObjectDataSource : System::Web::UI::DataSourceControl

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
    inherit DataSourceControl

Public Class ObjectDataSource
Inherits DataSourceControl

Herança: Object

Control

DataSourceControl
ObjectDataSource

Atributos: ToolboxBitmapAttribute

Exemplos

Esta seção mostra uma marcação ObjectDataSource in em uma página .aspx e mostra os objetos de negócios com os quais ela trabalha. O exemplo é a página .aspx. Ele contém um GridView controle associado a um ObjectDataSource controle . A ObjectDataSource marcação de controle especifica o nome do objeto comercial e o nome do método de objeto comercial a ser chamado para recuperar dados.

<%@ 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>

O exemplo a seguir mostra o objeto de negócios que o ObjectDataSource controle na página .aspx usa. (Muitos outros ObjectDataSource exemplos de código também usam esse objeto de negócios.) O exemplo consiste nas duas seguintes classes básicas:

A EmployeeLogic classe é a classe lógica de negócios que o ObjectDataSource usa.
A NorthwindEmployee classe define o objeto de dados retornado pelo GetAllEmployees método da EmployeeLogic classe .

Uma classe adicional NorthwindDataException é fornecida como uma conveniência.

Esse conjunto de classes de exemplo funciona com o banco de dados Northwind Traders, que está disponível com o Microsoft SQL Server e o Microsoft Access. Para obter um exemplo de trabalho completo, você deve compilar e usar essas classes com o exemplo de página .aspx fornecido.

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

Comentários

Neste tópico:

Introdução
Finalidade
Recuperando dados
Executando operações de dados
Filtrar dados
Cache
Recursos
Exibição de dados
Usando LINQ to SQL
Sintaxe declarativa

Introdução

Um ObjectDataSource controle funciona com uma classe que você cria. Você cria métodos que recuperam e atualizam dados e fornece os nomes desses métodos para o ObjectDataSource controle na marcação. Durante o processamento de renderização ou postback, o ObjectDataSource chama os métodos que você especificou.

Não há renderização visual do ObjectDataSource controle. Como resultado, o não dá suporte a ObjectDataSource recursos visuais, como a EnableTheming propriedade ou SkinID .

Finalidade

Uma prática de design de aplicativo muito comum é separar a camada de apresentação da lógica de negócios e encapsular a lógica de negócios em objetos de negócios. Esses objetos de negócios formam uma camada distinta entre a camada de apresentação e a camada de dados, resultando em uma arquitetura de aplicativo de três camadas. O ObjectDataSource controle permite que os desenvolvedores usem um controle de fonte de dados ASP.NET, mantendo sua arquitetura de aplicativo de três camadas.

O ObjectDataSource controle usa reflexão para criar instâncias de objetos de negócios e chamar métodos neles para recuperar, atualizar, inserir e excluir dados. A TypeName propriedade identifica o nome da classe com a qual o ObjectDataSource funciona. O ObjectDataSource controle cria e destrói uma instância da classe para cada chamada de método; ele não mantém o objeto na memória durante o tempo de vida da solicitação da Web. Essa é uma consideração séria se o objeto de negócios que você usa requer muitos recursos ou é caro para criar e destruir. Usar um objeto caro pode não ser uma opção de design ideal, mas você pode controlar o ciclo de vida do objeto usando os ObjectCreatingeventos , ObjectCreatede ObjectDisposing .

Observação

Os métodos identificados pelas SelectMethodpropriedades , UpdateMethod, InsertMethode DeleteMethod podem ser métodos de instância ou static (Shared no Visual Basic). Se os métodos forem static (Shared no Visual Basic), uma instância do objeto de negócios não será criada e os ObjectCreatingeventos , ObjectCreatede ObjectDisposing não serão gerados.

Recuperando dados

Para recuperar dados de um objeto de negócios, defina a SelectMethod propriedade como o nome do método que recupera dados. Se o método não retornar um IEnumerable objeto ou DataSet , o objeto será encapsulado pelo runtime em uma coleção IEnumerable . Se a assinatura do método tiver parâmetros, você poderá adicionar Parameter objetos à SelectParameters coleção e associá-los aos valores que você deseja passar para o método especificado pela SelectMethod propriedade . Para que o ObjectDataSource controle use os parâmetros, os parâmetros devem corresponder aos nomes e tipos dos parâmetros na assinatura do método. Para obter mais informações, consulte Usando parâmetros com o controle ObjectDataSource.

O ObjectDataSource controle recupera dados sempre que o Select método é chamado. Esse método fornece acesso programático ao método especificado pela SelectMethod propriedade . O método especificado pela SelectMethod propriedade é chamado automaticamente por controles associados ao quando o ObjectDataSourceDataBind método é chamado. Se você definir a DataSourceID propriedade de um controle associado a dados, o controle será automaticamente associado aos dados da fonte de dados, conforme necessário. Definir a DataSourceID propriedade é o método recomendado para associar um ObjectDataSource controle a um controle associado a dados. Como alternativa, você pode definir a DataSource propriedade, mas deve chamar explicitamente o DataBind método do controle associado a dados. Você pode chamar o Select método programaticamente a qualquer momento para recuperar dados.

Para obter mais informações sobre como associar controles associados a dados a controles de fonte de dados, consulte Associação a dados usando um controle de fonte de dados.

Executando operações de dados

Dependendo dos recursos do objeto de negócios com o qual o ObjectDataSource controle funciona, você pode executar operações de dados, como atualizações, inserções e exclusões. Para executar essas operações de dados, defina o nome do método apropriado e todos os parâmetros associados para a operação que você deseja executar. Por exemplo, para uma operação de atualização, defina a UpdateMethod propriedade como o nome do método de objeto de negócios que executa atualizações e adicione todos os UpdateParameters parâmetros necessários à coleção. Se o ObjectDataSource controle estiver associado a um controle associado a dados, os parâmetros serão adicionados pelo controle associado a dados. Nesse caso, você precisa garantir que os nomes de parâmetro do método correspondam aos nomes de campo no controle associado a dados. A atualização é executada quando o Update método é chamado explicitamente pelo código ou automaticamente por um controle associado a dados. O mesmo padrão geral é seguido para Delete operações e Insert . Supõe-se que os objetos de negócios executem esses tipos de operações de dados um registro por vez, em vez de em lote.

Filtrar dados

O ObjectDataSource controle pode filtrar os dados recuperados pela SelectMethod propriedade , se os dados forem retornados como um DataSet objeto ou DataTable . Você pode definir a FilterExpression propriedade como uma expressão de filtragem usando uma sintaxe de cadeia de caracteres de formato e associar valores na expressão a parâmetros especificados na FilterParameters coleção.

Cache

Embora o ObjectDataSource não mantenha a instância do objeto de negócios em várias solicitações, ele pode armazenar em cache o resultado de chamar o método identificado pela SelectMethod propriedade . Embora os dados sejam armazenados em cache, as chamadas subsequentes para o Select método retornam os dados armazenados em cache em vez de criar o objeto de negócios e chamá-los SelectMethod usando reflexão. O cache permite evitar criar o objeto e chamar seu método de dados em detrimento da memória no servidor Web. O ObjectDataSource armazena dados automaticamente em cache quando a EnableCaching propriedade é definida truecomo e a CacheDuration propriedade é definida como o número de segundos que o cache armazena dados antes que o cache seja descartado. Você também pode especificar uma CacheExpirationPolicy propriedade e uma propriedade opcional SqlCacheDependency . O ObjectDataSource controle permite armazenar em cache todos os tipos de dados, mas você não deve armazenar em cache objetos que retêm recursos ou estado que não podem ser compartilhados para atender a várias solicitações (por exemplo, um objeto aberto SqlDataReader ), pois a mesma instância do objeto será usada para atender a várias solicitações.

Recursos

A tabela a seguir descreve os recursos do ObjectDataSource controle.

Funcionalidade	Requisitos
Seleção	Defina a SelectMethod propriedade como o nome do método de objeto de negócios que seleciona dados e inclua todos os SelectParameters parâmetros necessários na coleção programaticamente ou usando um controle associado a dados.
Classificação	Defina a SortParameterName propriedade como o nome do parâmetro no SelectMethod método que contém os critérios de classificação.
Filtragem	Defina a FilterExpression propriedade como uma expressão de filtragem e, opcionalmente, adicione todos os FilterParameters parâmetros à coleção para filtrar os dados quando o Select método for chamado. O método especificado pela SelectMethod propriedade deve retornar um DataSet ou DataTable.
Paginamento	Há suporte para paginação de fonte de dados, se o SelectMethod método contiver parâmetros para o número máximo de registros a serem recuperados e o índice do primeiro registro a ser recuperado. Os nomes desses parâmetros devem ser definidos nas MaximumRowsParameterName propriedades e StartRowIndexParameterName , respectivamente. Um controle associado a dados pode ser capaz de executar a paginação em si, mesmo que o ObjectDataSource controle não dê suporte à paginação diretamente no método especificado pela SelectMethod propriedade . O requisito para que o controle associado a dados possa fazer isso é que o método especificado pela SelectMethod propriedade retorne um objeto que implementa a ICollection interface.
Atualizar	Defina a UpdateMethod propriedade como o nome do método de objeto de negócios que atualiza os dados e inclua todos os parâmetros necessários na UpdateParameters coleção.
Excluir	Defina a DeleteMethod propriedade como o nome do método ou função de objeto empresarial que exclui dados e inclua todos os parâmetros necessários na DeleteParameters coleção.
Inserindo	Defina a InsertMethod propriedade como o nome do método ou função de objeto empresarial que insere dados e inclua todos os parâmetros necessários na InsertParameters coleção.
Cache	Defina a EnableCaching propriedade como `true`e as CacheDuration propriedades e CacheExpirationPolicy de acordo com o comportamento de cache desejado para seus dados armazenados em cache.

Observação

Quando você usa a ObjectDataSource classe para atualizar ou inserir dados, as cadeias de caracteres inseridas no cliente não são convertidas automaticamente do formato de cultura do cliente para o formato de cultura do servidor. Por exemplo, a cultura do cliente pode especificar DD/MM/YYYY como o formato de data e o formato de data no servidor pode ser MM/DD/YYY. Nesse caso, 5 de outubro de 2009 seria inserido em um TextBox controle como 10/5/2009, mas seria interpretado como 10 de maio de 2009. 15 de outubro de 2009 seria inserido como 15/10/2009 e seria rejeitado como uma data inválida.

Exibição de dados

Assim como acontece com todos os controles de fonte de dados, o ObjectDataSource controle é associado a uma classe de exibição de fonte de dados. Embora o ObjectDataSource controle seja a interface que o desenvolvedor de página usa para trabalhar com dados, a ObjectDataSourceView classe é a interface com a qual os controles associados a dados funcionam. Além disso, a ObjectDataSourceView classe descreve os recursos do controle da fonte de dados e executa o trabalho real. O ObjectDataSource controle tem apenas um associado ObjectDataSourceViewe é sempre chamado DefaultViewde . Embora o ObjectDataSourceView objeto seja exposto pelo GetView método , muitas de suas propriedades e métodos são encapsulados e expostos diretamente pelo ObjectDataSource controle. Nos bastidores, o ObjectDataSourceView objeto executa todas as operações de dados, incluindo recuperação, inserção, atualização, exclusão, filtragem e classificação dos dados. Para obter mais informações, consulte ObjectDataSourceView.

Usando LINQ to SQL

Você pode usar o ObjectDataSource controle com uma classe LINQ to SQL. Para fazer isso, defina a TypeName propriedade como o nome da classe de contexto de dados. Você também define os SelectMethodmétodos , UpdateMethod, InsertMethode DeleteMethod para os métodos na classe de contexto de dados que executam as operações correspondentes. Você deve criar um manipulador de eventos para o ObjectDisposing evento para cancelar o descarte da classe de contexto de dados. Essa etapa é necessária porque o LINQ to SQL dá suporte à execução adiada, enquanto o ObjectDataSource controle tenta descartar o contexto de dados após a operação Select. Para obter mais informações sobre como criar classes LINQ to SQL, consulte Como criar classes LINQ to SQL em um projeto Web. Para obter um exemplo de como cancelar o descarte de uma classe de contexto de dados, consulte o ObjectDisposing evento .

Usando o Entity Framework

Você também pode usar o ObjectDataSource controle com o Entity Framework. Para obter mais informações, consulte Usando o Entity Framework e o controle ObjectDataSource.

Sintaxe declarativa

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

Construtores

ObjectDataSource()	Inicializa uma nova instância da classe ObjectDataSource.
ObjectDataSource(String, String)	Inicializa uma nova instância da classe ObjectDataSource com o nome do tipo e o nome do método de recuperação de dados especificados.

Propriedades

Adapter	Obtém o adaptador específico de navegador para o controle. (Herdado de Control)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control)
BindingContainer	Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control)
CacheDuration	Obtém ou define o período de tempo, em segundos, que o controle de fonte de dados armazena em cache os dados recuperados da propriedade SelectMethod.
CacheExpirationPolicy	Obtém ou define o comportamento de expiração de cache que, quando combinado com a duração, descreve o comportamento do cache usado pelo controle de fonte de dados.
CacheKeyDependency	Obtém ou define uma dependência de chave definida pelo usuário que é vinculada a todos os objetos de cache de dados que são criados pelo controle de fonte de dados.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control)
ClientID	Obtém o identificador de controle de servidor gerado pelo ASP.NET. (Herdado de DataSourceControl)
ClientIDMode	Essa propriedade não é usada para controles de fonte de dados. (Herdado de DataSourceControl)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control)
ConflictDetection	Obtém ou define um valor que determina se apenas os novos valores são passados para o método `Update` ou se os valores novos e antigos são passados para o método `Update`.
Context	Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de DataSourceControl)
ConvertNullToDBNull	Obtém ou define um valor que indica se os valores de Parameter passados para uma operação de atualização, inserção ou exclusão são convertidos automaticamente de `null` para o valor Value pelo controle ObjectDataSource.
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control)
DataObjectTypeName	Obtém ou define o nome de uma classe que controle o ObjectDataSource usa para um parâmetro em uma atualização, inserção ou exclusão da operação de dados, em vez de passar valores individuais do controle associado a dados.
DeleteMethod	Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para excluir os dados.
DeleteParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método DeleteMethod.
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
EnableCaching	Obtém ou define um valor que indica se o controle ObjectDataSource tem o cache de dados habilitado.
EnablePaging	Obtém ou define um valor que indica se o controle de fonte de dados dá suporte à paginação no conjunto de dados que recupera.
EnableTheming	Obtém um valor que indica se esse controle dá suporte a temas. (Herdado de DataSourceControl)
EnableViewState	Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
FilterExpression	Obtém ou define uma expressão de filtragem que é aplicada quando o método especificado pela propriedade SelectMethod é chamado.
FilterParameters	Obtém uma coleção de parâmetros associados a espaços reservados para parâmetros na cadeia de caracteres FilterExpression.
HasChildViewState	Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control)
ID	Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
InsertMethod	Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para inserir os dados.
InsertParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade InsertMethod.
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control)
IsTrackingViewState	Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
LoadViewStateByID	Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control)
MaximumRowsParameterName	Obtém ou define o nome do parâmetro de método de recuperação de dados do objeto comercial usado para indicar o número de registros a serem recuperados para suporte à paginação de fonte de dados.
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control)
OldValuesParameterFormatString	Obtém ou define uma cadeia de caracteres de formato para aplicar aos nomes dos parâmetros para os valores originais que são passados para os métodos `Delete` ou `Update`.
Page	Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control)
ParsingCulture	Obtém ou define um valor que indica quais informações de cultura são usadas ao converter valores de cadeia de caracteres em tipos de propriedade reais para construir um objeto do tipo indicado por DataObjectTypeName.
RenderingCompatibility	Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
SelectCountMethod	Obtém ou define o nome do método ou função invocada pelo controle ObjectDataSource para recuperar uma contagem de linhas.
SelectMethod	Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para recuperar dados.
SelectParameters	Obtém uma coleção de parâmetros que são usados pelo método especificado pela propriedade SelectMethod.
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control)
SkinID	Obtém a capa a ser aplicada ao controle DataSourceControl. (Herdado de DataSourceControl)
SortParameterName	Obtém ou define o nome do objeto comercial que o parâmetro SelectMethod usou para especificar uma expressão de classificação para suporte à classificação de fonte de dados.
SqlCacheDependency	Obtém ou define uma cadeia de caracteres separada por ponto-e-vírgula que indica quais bancos de dados e tabelas usar para a dependência de cache do Microsoft SQL Server.
StartRowIndexParameterName	Obtém ou define o nome do parâmetro de método de recuperação de dados usado para indicar o valor do identificador do primeiro registro a ser recuperado para o suporte à paginação de fonte de dados.
TemplateControl	Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control)
TypeName	Obtém ou define o nome da classe que o objeto ObjectDataSource representa.
UniqueID	Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control)
UpdateMethod	Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para atualizar os dados.
UpdateParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método especificado pela propriedade UpdateMethod.
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control)
Visible	Obtém ou define um valor indicando se o controle é exibido visualmente. (Herdado de DataSourceControl)

Métodos

AddedControl(Control, Int32)	Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor ClientID armazenado em cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control)
CreateChildControls()	Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control)
CreateControlCollection()	Cria uma coleção para armazenar controles filho. (Herdado de DataSourceControl)
DataBind()	Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Delete()	Executa uma operação de exclusão, chamando o método identificado pela propriedade DeleteMethod com os parâmetros que estão na coleção DeleteParameters.
Dispose()	Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
EnsureChildControls()	Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control)
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String)	Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro `id` especificado. (Herdado de DataSourceControl)
FindControl(String, Int32)	Procura o contêiner de nomenclatura atual para um controle de servidor com o `id` especificado e um inteiro especificado no parâmetro `pathOffset`, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl. (Herdado de Control)
Focus()	Define o foco de entrada para o controle. (Herdado de DataSourceControl)
GetDesignModeState()	Obtém os dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control)
GetView(String)	Recupera a exibição da fonte de dados nomeada que está associada ao controle de fonte de dados.
GetViewNames()	Recupera uma coleção de nomes que representa a lista de objetos de exibição que estão associados ao objeto ObjectDataSource.
HasControls()	Determina se o controle de servidor contém algum controle filho. (Herdado de DataSourceControl)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control)
Insert()	Executa uma operação de inserção chamando o método que é identificado pela propriedade InsertMethod e todos os parâmetros na coleção InsertParameters.
IsLiteralContent()	Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control)
LoadViewState(Object)	Carrega o estado de exibição salvo anteriormente do controle ObjectDataSource.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnBubbleEvent(Object, EventArgs)	Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnInit(EventArgs)	Adiciona um manipulador de eventos LoadComplete na página que contém o controle ObjectDataSource.
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de Control)
OnPreRender(EventArgs)	Aciona o evento PreRender. (Herdado de Control)
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control)
RaiseDataSourceChangedEvent(EventArgs)	Aciona o evento DataSourceChanged. (Herdado de DataSourceControl)
RemovedControl(Control)	Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Envia o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderControl(HtmlTextWriter)	Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control)
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control)
SaveViewState()	Salva o estado do controle ObjectDataSource.
Select()	Recupera dados do armazenamento de dados subjacente chamando o método identificado pela propriedade SelectMethod com os parâmetros na coleção SelectParameters.
SetDesignModeState(IDictionary)	Define os dados de tempo de design para um controle. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Controla as alterações de estado de exibição no controle ObjectDataSource, para que elas possam ser armazenadas no objeto StateBag.
Update()	Executa uma operação de atualização chamando o método que é identificado pela propriedade UpdateMethod e os parâmetros que estão na coleção UpdateParameters.

Eventos

DataBinding	Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control)
Deleted	Ocorre quando uma operação Delete() foi concluída.
Deleting	Ocorre antes de uma operação Delete().
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Filtering	Ocorre antes de uma operação de filtragem.
Init	Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control)
Inserted	Ocorre quando uma operação Insert() foi concluída.
Inserting	Ocorre antes de uma operação de Insert().
Load	Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control)
ObjectCreated	Ocorre depois que o objeto identificado pela propriedade TypeName é criado.
ObjectCreating	Ocorre antes que o objeto identificado pela propriedade TypeName é criado.
ObjectDisposing	Ocorre antes que o objeto identificado pela propriedade TypeName seja descartado.
PreRender	Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control)
Selected	Ocorre quando uma operação Select() foi concluída.
Selecting	Ocorre antes de uma operação Select().
Unload	Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control)
Updated	Ocorre quando uma operação Update() foi concluída.
Updating	Ocorre antes de uma operação de Update().

Implantações explícitas de interface

IControlBuilderAccessor.ControlBuilder	Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição desse membro, confira UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control)
IDataSource.DataSourceChanged	Ocorre quando um controle de fonte de dados foi alterado de forma que afeta controles associados a dados. (Herdado de DataSourceControl)
IDataSource.GetView(String)	Obtém um objeto DataSourceView nomeado associado ao controle DataSourceControl. Alguns controles de fonte de dados dão suporte a apenas uma exibição, enquanto outros dão suporte a mais de uma. (Herdado de DataSourceControl)
IDataSource.GetViewNames()	Obtém uma coleção de nomes, que representa a lista de objetos DataSourceView associados ao controle DataSourceControl. (Herdado de DataSourceControl)
IExpressionsAccessor.Expressions	Para obter uma descrição desse membro, confira Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control)
IListSource.ContainsListCollection	Indica se o controle de fonte de dados está associado a uma ou mais listas de dados. (Herdado de DataSourceControl)
IListSource.GetList()	Obtém uma lista de controles de fonte de dados que podem ser usados como fontes de listas de dados. (Herdado de DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control)

Métodos de Extensão

FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados do controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatable para o controle que contém dados.
GetDefaultValues(IDataSource)	Obtém a coleção de valores padrão para a fonte de dados especificada.
GetMetaTable(IDataSource)	Obtém os metadados para uma tabela no objeto de fonte de dados especificado.
TryGetMetaTable(IDataSource, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Partilhar via