ObjectDataSource Classe

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 de negócios que fornece dados para controles associados a dados em arquiteturas de aplicativos 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 em uma página .aspx e mostra os objetos de negócios com os quais ela funciona. 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 de negócios e o nome do método de objeto empresarial 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 classes básicas a seguir:

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
Purpose
Recuperando dados
Executando operações de dados
filtragem de dados
Cache
Características
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 pós-retorno, as ObjectDataSource chamadas são os métodos que você especificou.

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

Propósito

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 a ObjectDataSource classe 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 o ObjectCreating, ObjectCreatede ObjectDisposing os eventos.

Observação

Os métodos identificados pelo SelectMethodmétodo , UpdateMethode InsertMethod DeleteMethod as propriedades 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 e , ObjectCreatede ObjectDisposing os eventos, 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 um objeto, o objeto será encapsulado pelo runtime em uma IEnumerable coleção. 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 Como usar 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 por 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 empresarial 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 e Insert operações. Presume-se que os objetos comerciais executem esses tipos de operações de dados um registro por vez, em vez de em lotes.

Filtrar dados

O ObjectDataSource controle pode filtrar os dados recuperados pela SelectMethod propriedade, se os dados forem retornados como um objeto ou DataTable um DataSet objeto. 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.

Armazenamento em cache

Embora não ObjectDataSource mantenha a instância do objeto de negócios em várias solicitações, ele pode armazenar em cache o resultado da chamada do método identificado pela SelectMethod propriedade. Enquanto os dados são armazenados em cache, 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 que você evite criar o objeto e chamar seu método de dados em detrimento da memória no servidor Web. Os ObjectDataSource dados são armazenados em cache automaticamente quando a EnableCaching propriedade é definida truee 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.

Características

A tabela a seguir descreve os recursos do ObjectDataSource controle.

Capacidade	Requisitos
Selecionar	Defina a SelectMethod propriedade como o nome do método de objeto empresarial que seleciona dados e inclua todos os parâmetros necessários na SelectParameters 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 carrega 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.
Paging	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 no e StartRowIndexParameterName nas MaximumRowsParameterName propriedades, respectivamente. Um controle associado a dados pode ser capaz de executar a própria paginação, 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.
Atualização	Defina a UpdateMethod propriedade como o nome do método de objeto empresarial que atualiza os dados e inclua todos os parâmetros necessários na UpdateParameters coleção.
Excluindo	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.
Armazenamento em cache	Defina a EnableCaching propriedade como `true`, e as CacheDuration propriedades e CacheExpirationPolicy de acordo com o comportamento de cache que você deseja 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/YYYY. 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 da 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 nomeado DefaultView. 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 e os DeleteMethod UpdateMethod InsertMethodmé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 a eliminação 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 Como usar 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

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

Propriedades

Nome	Description
Adapter	Obtém o adaptador específico do navegador para o controle. (Herdado de Control)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control)
BindingContainer	Obtém o controle que contém a associação de dados desse controle. (Herdado de Control)
CacheDuration	Obtém ou define o período de tempo, em segundos, que o controle da fonte de dados armazena em cache os dados recuperados pela SelectMethod propriedade.
CacheExpirationPolicy	Obtém ou define o comportamento de expiração do cache que, quando combinado com a duração, descreve o comportamento do cache que o controle da fonte de dados usa.
CacheKeyDependency	Obtém ou define uma dependência de chave definida pelo usuário que está vinculada a todos os objetos de cache de dados criados pelo controle da fonte de dados.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control)
ClientID	Obtém o identificador de controle do 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 ClientID propriedade. (Herdado de Control)
ConflictDetection	Obtém ou define um valor que determina se apenas os novos valores são passados para o `Update` método ou os valores antigos e novos são passados para o `Update` método.
Context	Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de DataSourceControl)
ConvertNullToDBNull	Obtém ou define um valor que indica se os Parameter valores passados para uma operação de atualização, inserção ou exclusão são convertidos automaticamente no `null`Value valor pelo ObjectDataSource controle.
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl. (Herdado de Control)
DataObjectTypeName	Obtém ou define o nome de uma classe que o ObjectDataSource controle usa para um parâmetro em uma operação de dados de atualização, inserção ou exclusão, em vez de passar valores individuais do controle associado a dados.
DeleteMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controle invoca para excluir dados.
DeleteParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo DeleteMethod método.
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 tem o ObjectDataSource cache de dados habilitado.
EnablePaging	Obtém ou define um valor que indica se o controle da fonte de dados dá suporte à paginação por meio do conjunto de dados que ele 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 do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de representantes do 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 SelectMethod propriedade é chamado.
FilterParameters	Obtém uma coleção de parâmetros associados a quaisquer espaços reservados de parâmetro na FilterExpression cadeia de caracteres.
HasChildViewState	Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control)
ID	Obtém ou define o identificador programático atribuído ao controle do 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 função que o ObjectDataSource controle invoca para inserir dados.
InsertParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pela InsertMethod propriedade.
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control)
IsTrackingViewState	Obtém um valor que indica se o controle do servidor está salvando alterações em seu 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 no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control)
MaximumRowsParameterName	Obtém ou define o nome do parâmetro de método de recuperação de dados do objeto empresarial que é usado para indicar o número de registros a serem recuperados para o suporte à paginação da fonte de dados.
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
OldValuesParameterFormatString	Obtém ou define uma cadeia de caracteres de formato a ser aplicada aos nomes dos parâmetros para valores originais que são passados para os `Delete` métodos ou `Update` .
Page	Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de 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 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 que o ObjectDataSource controle invoca para recuperar uma contagem de linhas.
SelectMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controle invoca para recuperar dados.
SelectParameters	Obtém uma coleção de parâmetros que são usados pelo método especificado pela SelectMethod propriedade.
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design. (Herdado de Control)
SkinID	Obtém a pele a ser aplicada ao DataSourceControl controle. (Herdado de DataSourceControl)
SortParameterName	Obtém ou define o nome do objeto de negócios que o SelectMethod parâmetro usou para especificar uma expressão de classificação para o suporte à classificação da fonte de dados.
SqlCacheDependency	Obtém ou define uma cadeia de caracteres delimitada 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 do método de recuperação de dados que é usado para indicar o valor do identificador do primeiro registro a ser recuperado para o suporte à paginação da fonte de dados.
TemplateControl	Obtém ou define uma referência ao modelo que contém esse controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control)
TypeName	Obtém ou define o nome da classe que o ObjectDataSource objeto representa.
UniqueID	Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control)
UpdateMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controle invoca para atualizar dados.
UpdateParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método especificado pela UpdateMethod propriedade.
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de 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 StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se o controle é exibido visualmente. (Herdado de DataSourceControl)

Métodos

Nome	Description
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor armazenado em ClientID cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle do 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 do servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control)
CreateChildControls()	Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta 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 invocado e a todos os seus controles filho. (Herdado de Control)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (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 com todos os DeleteMethod parâmetros que estão na DeleteParameters coleção.
Dispose()	Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controle do servidor contém controles filho. Se isso não acontecer, 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, Int32)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado `id` e um inteiro, especificado no parâmetro, que `pathOffset` ajuda na pesquisa. Você não deve substituir essa versão do FindControl método. (Herdado de Control)
FindControl(String)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado `id` . (Herdado de DataSourceControl)
Focus()	Define o foco de entrada para o controle. (Herdado de DataSourceControl)
GetDesignModeState()	Obtém 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 UniqueID propriedade do controle especificado. (Herdado de Control)
GetView(String)	Recupera a exibição de fonte de dados nomeada associada ao controle da fonte de dados.
GetViewNames()	Recupera uma coleção de nomes que representa a lista de objetos de exibição associados ao ObjectDataSource objeto.
HasControls()	Determina se o controle do servidor contém controles filho. (Herdado de DataSourceControl)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control)
Insert()	Executa uma operação de inserção chamando o método identificado pela InsertMethod propriedade e quaisquer parâmetros na InsertParameters coleção.
IsLiteralContent()	Determina se o controle do servidor contém apenas 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 SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Carrega o estado de exibição salvo anteriormente do ObjectDataSource controle.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página. (Herdado de Control)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnInit(EventArgs)	Adiciona um LoadComplete manipulador de eventos à página que contém o ObjectDataSource controle.
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 todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control)
RaiseDataSourceChangedEvent(EventArgs)	Aciona o evento DataSourceChanged. (Herdado de DataSourceControl)
RemovedControl(Control)	Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Envia o conteúdo do controle do servidor para um objeto fornecido HtmlTextWriter , 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 fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (Herdado de DataSourceControl)
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 é utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor. (Herdado de Control)
SaveViewState()	Salva o estado do ObjectDataSource controle.
Select()	Recupera dados do armazenamento de dados subjacente chamando o método identificado pela SelectMethod propriedade com os parâmetros na SelectParameters coleção.
SetDesignModeState(IDictionary)	Define dados de tempo de design para um controle. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos 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 ObjectDataSource controle para que elas possam ser armazenadas no StateBag objeto.
Update()	Executa uma operação de atualização chamando o método identificado pela propriedade e todos os UpdateMethod parâmetros que estão na UpdateParameters coleção.

Eventos

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

Implantações explícitas de interface

Nome	Description
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição deste membro, consulte UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control)
IDataSource.DataSourceChanged	Ocorre quando um controle da fonte de dados é alterado de uma maneira que afeta controles associados a dados. (Herdado de DataSourceControl)
IDataSource.GetView(String)	Obtém o objeto nomeado DataSourceView associado ao DataSourceControl controle. 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, representando a lista de DataSourceView objetos associados ao DataSourceControl controle. (Herdado de DataSourceControl)
IExpressionsAccessor.Expressions	Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control)
IListSource.ContainsListCollection	Indica se o controle da 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 deste membro, consulte AddParsedSubObject(Object). (Herdado de Control)

Métodos de Extensão

Nome	Description
FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados para o controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatável para o controle de dados que contém.
GetDefaultValues(IDataSource)	Obtém a coleção dos valores padrão para a fonte de dados especificada.
GetMetaTable(IDataSource)	Obtém os metadados de 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

Confira também

Comentários

Esta página foi útil?

Partilhar via

ObjectDataSource Classe

Definição

Exemplos

Comentários

Introdução

Propósito

Recuperando dados

Executando operações de dados

Filtrar dados

Armazenamento em cache

Características

Exibição de dados

Usando LINQ to SQL

Usando o Entity Framework

Sintaxe declarativa

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a

Confira também

Comentários