ObjectDataSource Classe

Definição

Representa um objeto comercial que fornece dados a controles com associação de dados em arquiteturas de aplicativo Web multicamadas.Represents a business object that provides data to data-bound controls in multitier Web application architectures.

public ref class ObjectDataSource : System::Web::UI::DataSourceControl
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl
type ObjectDataSource = class
    inherit DataSourceControl
Public Class ObjectDataSource
Inherits DataSourceControl
Herança
ObjectDataSource
Atributos

Exemplos

Um projeto de site do Visual Studio com código-fonte está disponível para acompanhar este tópico: Baixar.A Visual Studio Web site project with source code is available to accompany this topic: Download.

Esta seção mostra uma ObjectDataSource marcação in em uma página. aspx e mostra os objetos comerciais com os quais ela trabalha.This section shows an ObjectDataSource in markup in an .aspx page and it shows the business objects that it works with. O exemplo é a página. aspx.The example is the .aspx page. Ele contém um GridView controle que está associado a um ObjectDataSource controle.It contains a GridView control that is bound to an ObjectDataSource control. A ObjectDataSource marcação de controle Especifica o nome do objeto comercial e o nome do método de objeto comercial a ser chamado a fim de recuperar dados.The ObjectDataSource control markup specifies the name of the business object and the name of the business object method to call in order to retrieve data.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

    </form>
  </body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic" />

    </form>
  </body>
</html>

O exemplo a seguir mostra o objeto comercial que ObjectDataSource o controle na página. aspx usa.The following example shows the business object that the ObjectDataSource control in the .aspx page uses. (Muitos outros ObjectDataSource exemplos de código também usam esse objeto comercial.) O exemplo consiste nas duas classes básicas a seguir:(Many other ObjectDataSource code examples use this business object also.) The example consists of the following two basic classes:

  • A EmployeeLogic classe é a classe de lógica de negócios ObjectDataSource que o usa.The EmployeeLogic class is the business logic class that the ObjectDataSource uses.

  • A NorthwindEmployee classe define o objeto de dados que é retornado GetAllEmployees pelo método da EmployeeLogic classe.The NorthwindEmployee class defines the data object that is returned by the GetAllEmployees method of the EmployeeLogic class.

Uma classe NorthwindDataException adicional é fornecida como uma conveniência.An additional NorthwindDataException class is provided as a convenience.

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.This set of example classes works with the Northwind Traders database, which is available with Microsoft SQL Server and Microsoft Access. Para obter um exemplo funcional completo, você deve compilar e usar essas classes com o exemplo de página. aspx fornecido.For a complete working example, you must compile and use these classes with the .aspx page example that is provided. Para obter informações sobre como instalar o banco de dados Northwind Traders, consulte como: Instalar bancos de dadosde exemplo.For information about how to install the Northwind Traders database, see How to: Install Sample Databases.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Collections.Specialized;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates
  // the operations one can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {

    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

      SqlDataSource sds
        = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

      try {

        IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

        // Iterate through the Enumeration and create a
        // NorthwindEmployee object for each ID.
        foreach (DataRowView row in IDs) {
          string id = row["EmployeeID"].ToString();
          NorthwindEmployee nwe = new NorthwindEmployee(id);
          // Add the NorthwindEmployee object to the collection.
          al.Add(nwe);
        }
      }
      finally {
        // If anything strange happens, clean up.
        sds.Dispose();
      }

      return al;
    }
    public static NorthwindEmployee GetEmployee(object anID) {
      return new NorthwindEmployee(anID);
    }

    public static void UpdateEmployeeInfo(NorthwindEmployee ne) {
      bool retval = ne.Save();
      if (! retval) { throw new NorthwindDataException("UpdateEmployee failed."); }
    }

    public static void DeleteEmployee(NorthwindEmployee ne) { }

  }

  public class NorthwindEmployee {

    public NorthwindEmployee () {
      ID = DBNull.Value;
      lastName = "";
      firstName = "";
      title="";
      titleOfCourtesy = "";
      reportsTo = -1;
    }

    public NorthwindEmployee (object anID) {
      this.ID = anID;

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

        SqlConnection conn = new SqlConnection (cts.ConnectionString);
      SqlCommand sc =
        new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
                       " FROM Employees " +
                       " WHERE EmployeeID = @empId",
                       conn);
      // Add the employee ID parameter and set its value.
      sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
      SqlDataReader sdr = null;

      try {
        conn.Open();
        sdr = sc.ExecuteReader();

        // This is not a while loop. It only loops once.
        if (sdr != null && sdr.Read()) {
          // The IEnumerable contains DataRowView objects.
          this.firstName        = sdr["FirstName"].ToString();
          this.lastName         = sdr["LastName"].ToString();
          this.title            = sdr["Title"].ToString();
          this.titleOfCourtesy  = sdr["TitleOfCourtesy"].ToString();
          if (! sdr.IsDBNull(4)) {
            this.reportsTo        = sdr.GetInt32(4);
          }
        }
        else {
          throw new NorthwindDataException("Data not loaded for employee id.");
        }
      }
      finally {
        try {
          if (sdr != null) sdr.Close();
          conn.Close();
        }
        catch (SqlException) {
          // Log an event in the Application Event Log.
          throw;
        }
      }
    }

    private object ID;

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }

    private string title;
    public String Title {
      get { return title; }
      set { title = value; }
    }

    private string titleOfCourtesy;
    public string Courtesy {
      get { return titleOfCourtesy; }
      set { titleOfCourtesy = value; }
    }

    private int    reportsTo;
    public int Supervisor {
      get { return reportsTo; }
      set { reportsTo = value; }
    }

    public bool Save () {
      return true;
    }
  }

  internal class NorthwindDataException: Exception {
    public NorthwindDataException(string msg) : base (msg) { }
  }
}
Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
' When the class is written in Visual Basic, you cannot use the Shared
' part.
Public Class EmployeeLogic
   ' Returns a collection of NorthwindEmployee objects.
   Public Shared Function GetAllEmployees() As ICollection
      Dim al As New ArrayList()

      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
      Try
         Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

         ' Iterate through the Enumeration and create a
         ' NorthwindEmployee object for each ID.
         For Each row As DataRowView In IDs
            Dim id As String = row("EmployeeID").ToString()
            Dim nwe As New NorthwindEmployee(id)
            ' Add the NorthwindEmployee object to the collection.
            al.Add(nwe)
         Next
      Finally
         ' If anything strange happens, clean up.
         sds.Dispose()
      End Try

      Return al
   End Function 'GetAllEmployees

   Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
      Return New NorthwindEmployee(anID)
   End Function 'GetEmployee


   Public Shared Sub UpdateEmployeeInfo(ne As NorthwindEmployee)
      Dim retval As Boolean = ne.Save()
      If Not retval Then
         Throw New NorthwindDataException("UpdateEmployee failed.")
      End If
   End Sub

   Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
   End Sub

End Class


Public Class NorthwindEmployee


   Public Sub New()
      ID = DBNull.Value
      aLastName = ""
      aFirstName = ""
      aTitle = ""
      titleOfCourtesy = ""
      reportsTo = - 1
   End Sub


   Public Sub New(anID As Object)
      Me.ID = anID
      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim conn As New SqlConnection(cts.ConnectionString)
      Dim sc As New SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " & _
                               " FROM Employees " & _
                               " WHERE EmployeeID = @empId", conn)
      ' Add the employee ID parameter and set its value.
      sc.Parameters.Add(New SqlParameter("@empId", SqlDbType.Int)).Value = Int32.Parse(anID.ToString())
      Dim sdr As SqlDataReader = Nothing

      Try
         conn.Open()
         sdr = sc.ExecuteReader()

         ' This is not a while loop. It only loops once.
         If Not (sdr Is Nothing) AndAlso sdr.Read() Then
            ' The IEnumerable contains DataRowView objects.
            Me.aFirstName = sdr("FirstName").ToString()
            Me.aLastName = sdr("LastName").ToString()
            Me.aTitle = sdr("Title").ToString()
            Me.titleOfCourtesy = sdr("TitleOfCourtesy").ToString()
            If Not sdr.IsDBNull(4) Then
               Me.reportsTo = sdr.GetInt32(4)
            End If
         Else
            Throw New NorthwindDataException("Data not loaded for employee id.")
         End If
      Finally
         Try
            If Not (sdr Is Nothing) Then
               sdr.Close()
            End If
            conn.Close()
         Catch se As SqlException
            ' Log an event in the Application Event Log.
            Throw
         End Try
      End Try
   End Sub

   Private ID As Object

   Private aLastName As String
   Public Property LastName() As String
      Get
         Return aLastName
      End Get
      Set
         aLastName = value
      End Set
   End Property

   Private aFirstName As String
   Public Property FirstName() As String
      Get
         Return aFirstName
      End Get
      Set
         aFirstName = value
      End Set
   End Property

   Private aTitle As String
   Public Property Title() As String
      Get
         Return aTitle
      End Get
      Set
         aTitle = value
      End Set
   End Property

   Private titleOfCourtesy As String
   Public Property Courtesy() As String
      Get
         Return titleOfCourtesy
      End Get
      Set
         titleOfCourtesy = value
      End Set
   End Property
   Private reportsTo As Integer

   Public Property Supervisor() As Integer
      Get
         Return reportsTo
      End Get
      Set
         reportsTo = value
      End Set
   End Property

   Public Function Save() As Boolean
      Return True
   End Function 'Save
End Class


Friend Class NorthwindDataException
   Inherits Exception

   Public Sub New(msg As String)
      MyBase.New(msg)
   End Sub
End Class
End Namespace

Comentários

Neste tópico:In this topic:

IntroduçãoIntroduction

Um ObjectDataSource controle funciona com uma classe que você cria.An ObjectDataSource control works with a class that you create. Você cria métodos que recuperam e atualizam dados e fornece os nomes desses métodos para o ObjectDataSource controle na marcação.You create methods that retrieve and update data, and you provide the names of those methods to the ObjectDataSource control in markup. Durante a renderização ou o processamento de ObjectDataSource postback, o chama os métodos que você especificou.During rendering or postback processing, the ObjectDataSource calls the methods that you have specified.

Não há renderização visual do ObjectDataSource controle.There is no visual rendering of the ObjectDataSource control. Como resultado, o ObjectDataSource não oferece suporte a recursos visuais, como a EnableTheming propriedade ou. SkinIDAs a result, the ObjectDataSource does not support visual features such as the EnableTheming or SkinID property.

FinalidadePurpose

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 comerciais.A very common application design practice is to separate the presentation layer from business logic and to encapsulate the business logic in business objects. Esses objetos comerciais 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.These business objects form a distinct layer between the presentation layer and the data tier, resulting in a three-tier application architecture. O ObjectDataSource controle permite que os desenvolvedores usem um controle da fonte de dados ASP.net enquanto retêm sua arquitetura de aplicativos de três camadas.The ObjectDataSource control enables developers to use an ASP.NET data source control while retaining their three-tier application architecture.

O ObjectDataSource controle usa a reflexão para criar instâncias de objetos comerciais e chamar métodos para recuperar, atualizar, inserir e excluir dados.The ObjectDataSource control uses reflection to create instances of business objects and to call methods on them to retrieve, update, insert, and delete data. A TypeName propriedade identifica o nome da classe com a qual ObjectDataSource o funciona.The TypeName property identifies the name of the class that the ObjectDataSource works with. 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.The ObjectDataSource control creates and destroys an instance of the class for each method call; it does not hold the object in memory for the lifetime of the Web request. Essa é uma consideração séria se o objeto comercial que você usa requer muitos recursos ou é caro criar e destruir.This is a serious consideration if the business object that you use requires many resources or is otherwise expensive to create and destroy. 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 ObjectCreated, e ObjectDisposing .Using an expensive object might not be an optimal design choice, but you can control the life cycle of the object by using the ObjectCreating, ObjectCreated, and ObjectDisposing events.

Observação

Os métodos SelectMethodque são identificados pelas propriedades InsertMethod, UpdateMethod,, e DeleteMethod podem ser métodos de instância ou static (Shared em Visual Basic) métodos.The methods that are identified by the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod properties can be instance methods or static (Shared in Visual Basic) methods. Se os métodos estiverem static (Shared em Visual Basic), uma instância do objeto comercial não será criada ObjectDisposing e os ObjectCreatingeventos, ObjectCreatede não serão gerados.If the methods are static (Shared in Visual Basic), an instance of the business object is not created, and the ObjectCreating, ObjectCreated, and ObjectDisposing events are not raised.

Recuperando dadosRetrieving Data

Para recuperar dados de um objeto comercial, defina a SelectMethod Propriedade como o nome do método que recupera dados.To retrieve data from a business object, set the SelectMethod property to the name of the method that retrieves data. Se o método não retornar um IEnumerable objeto ou DataSet , o objeto será encapsulado pelo tempo de execução em uma IEnumerable coleção.If the method does not return an IEnumerable or DataSet object, the object is wrapped by the runtime in an IEnumerable collection. Se a assinatura do método tiver parâmetros, você poderá Parameter adicionar objetos SelectParameters à coleção e, em seguida, associá-los aos valores que você deseja passar para o método especificado pela SelectMethod propriedade.If the method signature has parameters, you can add Parameter objects to the SelectParameters collection, and then bind them to the values that you want to pass to the method that is specified by the SelectMethod property. 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.In order for the ObjectDataSource control to use the parameters, the parameters must match the names and types of the parameters in the method signature. Para obter mais informações, consulte usando parâmetros com o controle ObjectDataSource.For more information, see Using Parameters with the ObjectDataSource Control.

O ObjectDataSource controle recupera dados sempre que Select o método é chamado.The ObjectDataSource control retrieves data whenever the Select method is called. Esse método fornece acesso programático ao método especificado pela SelectMethod propriedade.This method provides programmatic access to the method that is specified by SelectMethod property. O método especificado pela SelectMethod propriedade é chamado automaticamente pelos controles que são associados ObjectDataSource ao quando seu DataBind método é chamado.The method that is specified by the SelectMethod property is called automatically by controls that are bound to the ObjectDataSource when their DataBind method is called. Se você definir a DataSourceID propriedade de um controle de vinculação de dados, o controle será automaticamente associado a dados da fonte de dados, conforme necessário.If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as needed. Definir a DataSourceID propriedade é o método recomendado para associar um ObjectDataSource controle a um controle de vinculação de dados.Setting the DataSourceID property is the recommended method for binding an ObjectDataSource control to a data-bound control. Como alternativa, você pode definir a DataSource Propriedade, mas, em seguida, deve chamar DataBind explicitamente o método do controle de vinculação de dados.Alternatively, you can set the DataSource property, but then you must explicitly call the DataBind method of the data-bound control. Você pode chamar o Select método programaticamente a qualquer momento para recuperar dados.You can call the Select method programmatically at any time to retrieve data.

Para obter mais informações sobre como associar controles vinculados a dados a controles de fonte de dados, consulte associação a dados usando um controle da fonte de dados.For more information about binding data-bound controls to data source controls, see Binding to Data Using a Data Source Control.

Executando operações de dadosPerforming Data Operations

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.Depending on the capabilities of the business object that the ObjectDataSource control works with, you can perform data operations, such as updates, insertions, and deletions. Para executar essas operações de dados, defina o nome do método apropriado e quaisquer parâmetros associados para a operação que você deseja executar.To perform these data operations, set the appropriate method name and any associated parameters for the operation that you want to perform. Por exemplo, para uma operação de atualização, defina UpdateMethod a propriedade como o nome do método de objeto comercial que executa atualizações e adicione todos os parâmetros necessários UpdateParameters à coleção.For example, for an update operation, set the UpdateMethod property to the name of the business object method that performs updates and add any required parameters to the UpdateParameters collection. Se o ObjectDataSource controle estiver associado a um controle vinculado a dados, os parâmetros serão adicionados pelo controle de vinculação de dados.If the ObjectDataSource control is associated with a data-bound control, the parameters are added by the data-bound control. Nesse caso, você precisa garantir que os nomes de parâmetro do método correspondam aos nomes de campo no controle de vinculação de dados.In this case, you need to ensure that the parameter names of the method match the field names in the data-bound control. A atualização é executada quando o Update método é chamado, explicitamente pelo seu código ou automaticamente por um controle vinculado a dados.The update is performed when the Update method is called, either explicitly by your code or automatically by a data-bound control. O mesmo padrão geral é seguido para Delete operações Insert e.The same general pattern is followed for Delete and Insert operations. Os objetos comerciais são considerados para executar esses tipos de operações de dados, um registro por vez, em vez de em lote.Business objects are assumed to perform these types of data operations one record at a time, rather than batched.

Filtrar dadosFiltering Data

O ObjectDataSource controle pode filtrar os dados recuperados SelectMethod pela propriedade, se os dados forem retornados como um DataSet objeto ou DataTable .The ObjectDataSource control can filter data that is retrieved by the SelectMethod property, if the data is returned as a DataSet or DataTable object. Você pode definir a FilterExpression propriedade para uma expressão de filtragem usando uma sintaxe de cadeia de caracteres de formato e associar valores na expressão a parâmetros especificados FilterParameters na coleção.You can set the FilterExpression property to a filtering expression by using a format string syntax and bind values in the expression to parameters that are specified in the FilterParameters collection.

CacheCaching

Embora o ObjectDataSource não retenha a instância do objeto comercial em várias solicitações, ele pode armazenar em cache o resultado da chamada do método identificado SelectMethod pela propriedade.Although the ObjectDataSource does not retain the instance of the business object across multiple requests, it can cache the result of calling the method identified by the SelectMethod property. Enquanto os dados são armazenados em cache, as chamadas subsequentes para o Select método retornam os dados armazenados em cache em vez de criar o objeto comercial e chamar seu SelectMethod usando reflexão.While the data is cached, subsequent calls to the Select method return the cached data instead of creating the business object and calling its SelectMethod using reflection. O Caching permite evitar a criação do objeto e a chamada de seu método de dados às custas da memória no servidor Web.Caching lets you avoid creating the object and calling its data method at the expense of memory on the Web server. O ObjectDataSource armazena automaticamente os dados em cache EnableCaching quando a propriedade é truedefinida como, CacheDuration e a propriedade é definida como o número de segundos que o cache armazena os dados antes de o cache ser Descartado.The ObjectDataSource automatically caches data when the EnableCaching property is set to true, and the CacheDuration property is set to the number of seconds that the cache stores data before the cache is discarded. Você também pode especificar uma CacheExpirationPolicy Propriedade e uma propriedade SqlCacheDependency opcional.You can also specify a CacheExpirationPolicy property and an optional SqlCacheDependency property. O ObjectDataSource controle permite armazenar em cache todos os tipos de dados, mas você não deve armazenar em cache os objetos que retêm recursos ou Estados que não podem ser compartilhados para atender a várias SqlDataReader solicitações (por exemplo, um objeto aberto), porque a mesma instância do objeto será usado para atender a várias solicitações.The ObjectDataSource control allows you to cache all types of data, but you should not cache objects that retain resources or state that cannot be shared to service multiple requests (for example, an open SqlDataReader object), because the same instance of the object will be used to service multiple requests.

RecursosFeatures

A tabela a seguir descreve os recursos do ObjectDataSource controle.The following table describes the features of the ObjectDataSource control.

RecursoCapability RequisitosRequirements
SelecionandoSelecting Defina a SelectMethod Propriedade como o nome do método de objeto comercial que seleciona dados e inclua todos os parâmetros necessários SelectParameters na coleção de forma programática ou usando um controle associado a dados.Set the SelectMethod property to the name of the business object method that selects data, and include any necessary parameters in the SelectParameters collection either programmatically or by using a data-bound control.
ClassificaçãoSorting Defina a SortParameterName Propriedade como o nome do parâmetro SelectMethod no método que transporta os critérios de classificação.Set the SortParameterName property to the name of the parameter in the SelectMethod method that carries the sort criteria.
FiltragemFiltering Defina a FilterExpression Propriedade como uma expressão de filtragem e, opcionalmente, adicione quaisquer FilterParameters parâmetros à coleção para filtrar os dados Select quando o método for chamado.Set the FilterExpression property to a filtering expression and optionally add any parameters to the FilterParameters collection to filter the data when the Select method is called. O método especificado pela SelectMethod propriedade deve retornar um DataSet ou DataTable.The method specified by the SelectMethod property must return a DataSet or DataTable.
PaginaçãoPaging Haverá suporte para paginação da fonte SelectMethod de dados, se o 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.Data source paging is supported, if the SelectMethod method contains parameters for the maximum number of records to retrieve and the index of the first record to retrieve. Os nomes desses parâmetros devem ser definidos nas MaximumRowsParameterName Propriedades e StartRowIndexParameterName , respectivamente.The names of those parameters must be set in the MaximumRowsParameterName and StartRowIndexParameterName properties, respectively. Um controle vinculado a dados pode ser capaz de executar a paginação em si ObjectDataSource , mesmo que o controle não ofereça suporte à paginação SelectMethod diretamente no método especificado pela propriedade.A data-bound control might be able to perform paging itself, even if the ObjectDataSource control does not support paging directly in the method specified by the SelectMethod property. O requisito para o controle de vinculação de dados ser capaz de fazer isso é que o método especificado pela SelectMethod propriedade retorna um objeto que implementa a ICollection interface.The requirement for the data-bound control to be able to do this is that the method specified by the SelectMethod property return an object that implements the ICollection interface.
AtualizandoUpdating Defina a UpdateMethod Propriedade como o nome do método de objeto comercial que atualiza os dados e inclua todos os parâmetros necessários UpdateParameters na coleção.Set the UpdateMethod property to the name of the business object method that updates data, and include any necessary parameters in the UpdateParameters collection.
ExcluindoDeleting Defina a DeleteMethod Propriedade como o nome do método ou função de objeto comercial que exclui dados e inclua todos os parâmetros necessários DeleteParameters na coleção.Set the DeleteMethod property to the name of the business object method or function that deletes data, and include any necessary parameters in the DeleteParameters collection.
InserindoInserting Defina a InsertMethod Propriedade como o nome do método ou função de objeto comercial que insere dados e inclua todos os parâmetros necessários InsertParameters na coleção.Set the InsertMethod property to the name of the business object method or function that inserts data, and include any necessary parameters in the InsertParameters collection.
CacheCaching Defina a EnableCaching Propriedade como true, e as CacheDuration propriedades CacheExpirationPolicy e de acordo com o comportamento de cache desejado para os dados armazenados em cache.Set the EnableCaching property to true, and the CacheDuration and CacheExpirationPolicy properties according to the caching behavior you want for your cached data.

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.When you use the ObjectDataSource class to update or insert data, strings that are entered at the client are not automatically converted from the client culture format to the server culture format. Por exemplo, a cultura do cliente pode especificar DD/MM/aaaa como o formato de data e o formato de data no servidor pode ser MM/DD/AAAA.For example, the client culture might specify DD/MM/YYYY as the date format, and the date format on the server might be MM/DD/YYYY. Nesse caso, 5 de outubro de 2009 seriam inseridos em um TextBox controle como 5/10/2009, mas seriam interpretados como 10 de maio de 2009.In that case, October 5, 2009 would be entered in a TextBox control as 5/10/2009 but would be interpreted as May 10, 2009. 15 de outubro de 2009 seria inserido como 15/10/2009 e seria rejeitado como uma data inválida.October 15, 2009 would be entered as 15/10/2009, and would be rejected as an invalid date.

Exibição de dadosData View

Assim como acontece com todos os controles de ObjectDataSource fonte de dados, o controle é associado a uma classe de exibição da fonte de dados.As with all data source controls, the ObjectDataSource control is associated with a data source view class. Embora o ObjectDataSource controle seja a interface que o desenvolvedor de página usa para trabalhar com os dados ObjectDataSourceView , a classe é a interface com a qual os controles associados a dados funcionam.While the ObjectDataSource control is the interface that the page developer uses to work with data, the ObjectDataSourceView class is the interface that data-bound controls work with. Além disso, ObjectDataSourceView a classe descreve os recursos do controle da fonte de dados e executa o trabalho real.Additionally, the ObjectDataSourceView class describes the capabilities of the data source control, and performs the actual work. O ObjectDataSource controle tem apenas um associado ObjectDataSourceViewe sempre é nomeado DefaultView.The ObjectDataSource control has only one associated ObjectDataSourceView, and it is always named DefaultView. Embora o ObjectDataSourceView objeto seja exposto GetView pelo método, muitas de suas propriedades e métodos são encapsuladas ObjectDataSource e expostas diretamente pelo controle.While the ObjectDataSourceView object is exposed by the GetView method, many of its properties and methods are wrapped and exposed directly by the ObjectDataSource control. Nos bastidores, o ObjectDataSourceView objeto executa todas as operações de dados, incluindo a recuperação, inserção, atualização, exclusão, filtragem e classificação dos dados.Behind the scenes, the ObjectDataSourceView object performs all data operations, including retrieving, inserting, updating, deleting, filtering, and sorting the data. Para obter mais informações, consulte ObjectDataSourceView.For more information, see ObjectDataSourceView.

Usando LINQ to SQLUsing LINQ to SQL

Você pode usar o ObjectDataSource controle com uma classe LINQ to SQL.You can use the ObjectDataSource control with a LINQ to SQL class. Para fazer isso, defina a TypeName Propriedade como o nome da classe de contexto de dados.To do so, you set the TypeName property to the name of the data-context class. Você também define os SelectMethodmétodos UpdateMethod, InsertMethod, e DeleteMethod para os métodos na classe de contexto de dados que executam as operações correspondentes.You also set the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod methods to the methods in the data-context class that perform the corresponding operations. Você deve criar um manipulador de eventos para ObjectDisposing o evento a fim de cancelar a alienação da classe de contexto de dados.You must create an event handler for the ObjectDisposing event in order to cancel disposing of the data-context class. Essa etapa é necessária porque LINQ to SQL dá suporte à execução adiada, ObjectDataSource enquanto o controle tenta descartar o contexto de dados após a operação de seleção.This step is necessary because LINQ to SQL supports deferred execution, whereas the ObjectDataSource control tries to dispose the data context after the Select operation. Para obter mais informações sobre como criar classes de LINQ to SQL, consulte Como: Crie LINQ to SQL classes em um projetoWeb.For more information about how to create LINQ to SQL classes, see How to: Create LINQ to SQL Classes in a Web Project. Para obter um exemplo de como cancelar a descartação de uma classe de contexto de ObjectDisposing dados, consulte o evento.For an example of how to cancel the disposing of a data context class, see the ObjectDisposing event.

Usando o Entity FrameworkUsing the Entity Framework

Você também pode usar o ObjectDataSource controle com o Entity Framework.You can also use the ObjectDataSource control with the Entity Framework. Para obter mais informações, consulte usando o Entity Framework e o controle ObjectDataSource.For more information, see Using the Entity Framework and the ObjectDataSource Control.

Sintaxe declarativaDeclarative Syntax

<asp:ObjectDataSource  
    CacheDuration="string|Infinite"  
    CacheExpirationPolicy="Absolute|Sliding"  
    CacheKeyDependency="string"  
    ConflictDetection="OverwriteChanges|CompareAllValues"  
    ConvertNullToDBNull="True|False"  
    DataObjectTypeName="string"  
    DeleteMethod="string"  
    EnableCaching="True|False"  
    EnablePaging="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    FilterExpression="string"  
    ID="string"  
    InsertMethod="string"  
    MaximumRowsParameterName="string"  
    OldValuesParameterFormatString="string"  
    OnDataBinding="DataBinding event handler"  
    OnDeleted="Deleted event handler"  
    OnDeleting="Deleting event handler"  
    OnDisposed="Disposed event handler"  
    OnFiltering="Filtering event handler"  
    OnInit="Init event handler"  
    OnInserted="Inserted event handler"  
    OnInserting="Inserting event handler"  
    OnLoad="Load event handler"  
    OnObjectCreated="ObjectCreated event handler"  
    OnObjectCreating="ObjectCreating event handler"  
    OnObjectDisposing="ObjectDisposing event handler"  
    OnPreRender="PreRender event handler"  
    OnSelected="Selected event handler"  
    OnSelecting="Selecting event handler"  
    OnUnload="Unload event handler"  
    OnUpdated="Updated event handler"  
    OnUpdating="Updating event handler"  
    runat="server"  
    SelectCountMethod="string"  
    SelectMethod="string"  
    SkinID="string"  
    SortParameterName="string"  
    SqlCacheDependency="string"  
    StartRowIndexParameterName="string"  
    TypeName="string"  
    UpdateMethod="string"  
    Visible="True|False"  
>  
        <DeleteParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </DeleteParameters>  
        <FilterParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </FilterParameters>  
        <InsertParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </InsertParameters>  
        <SelectParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </SelectParameters>  
        <UpdateParameters>  
                <asp:ControlParameter  
                    ControlID="string"  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:CookieParameter  
                    ConvertEmptyStringToNull="True|False"  
                    CookieName="string"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:FormParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    FormField="string"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:Parameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:ProfileParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    PropertyName="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:QueryStringParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    QueryStringField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
                <asp:SessionParameter  
                    ConvertEmptyStringToNull="True|False"  
                    DefaultValue="string"  
                    Direction="Input|Output|InputOutput|ReturnValue"  
                    Name="string"  
                    SessionField="string"  
                    Size="integer"  
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|  
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|  
                        Single|Double|Decimal|DateTime|String"  
                />  
        </UpdateParameters>  
</asp:ObjectDataSource>  

Construtores

ObjectDataSource()

Inicializa uma nova instância da classe ObjectDataSource.Initializes a new instance of the ObjectDataSource class.

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

Propriedades

Adapter

Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control.

(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.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Herdado de Control)
BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding.

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

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

CacheKeyDependency

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.Gets or sets a user-defined key dependency that is linked to all data cache objects that are created by the data source control.

ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created.

(Herdado de Control)
ClientID

Obtém o identificador de controle de servidor gerado pelo ASP.NET.Gets the server control identifier generated by ASP.NET.

(Herdado de DataSourceControl)
ClientIDMode

Essa propriedade não é usada para controles de fonte de dados.This property is not used for data source controls.

(Herdado de DataSourceControl)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property.

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

Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request.

(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.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

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

DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements 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.Gets or sets the name of a class that the ObjectDataSource control uses for a parameter in an update, insert, or delete data operation, instead of passing individual values from the data-bound control.

DeleteMethod

Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para excluir os dados.Gets or sets the name of the method or function that the ObjectDataSource control invokes to delete data.

DeleteParameters

Obtém a coleção de parâmetros que contém os parâmetros usados pelo método DeleteMethod.Gets the parameters collection that contains the parameters that are used by the DeleteMethod method.

DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface.

(Herdado de Control)
EnableCaching

Obtém ou define um valor que indica se o controle ObjectDataSource tem o cache de dados habilitado.Gets or sets a value indicating whether the ObjectDataSource control has data caching enabled.

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.Gets or sets a value that indicates whether the data source control supports paging through the set of data that it retrieves.

EnableTheming

Obtém um valor que indica se esse controle dá suporte a temas.Gets a value indicating whether this control supports themes.

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

(Herdado de Control)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Esta propriedade é somente para leitura.This property is read-only.

(Herdado de Control)
FilterExpression

Obtém ou define uma expressão de filtragem que é aplicada quando o método especificado pela propriedade SelectMethod é chamado.Gets or sets a filtering expression that is applied when the method that is specified by the SelectMethod property is called.

FilterParameters

Obtém uma coleção de parâmetros associados a espaços reservados para parâmetros na cadeia de caracteres FilterExpression.Gets a collection of parameters that are associated with any parameter placeholders in the FilterExpression string.

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.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Herdado de Control)
ID

Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers.

(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.Gets or sets the name of the method or function that the ObjectDataSource control invokes to insert data.

InsertParameters

Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade InsertMethod.Gets the parameters collection that contains the parameters that are used by the InsertMethod property.

IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state.

(Herdado de Control)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state.

(Herdado de Control)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control.

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

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

NamingContainer

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

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

Page

Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy.

(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.Gets a or sets a value that indicates what culture information is used when converting string values to actual property types in order to construct an object of the type indicated by DataObjectTypeName.

RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(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.Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve a row count.

SelectMethod

Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para recuperar dados.Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve data.

SelectParameters

Obtém uma coleção de parâmetros que são usados pelo método especificado pela propriedade SelectMethod.Gets a collection of parameters that are used by the method specified by the SelectMethod property.

Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface.

(Herdado de Control)
SkinID

Obtém a capa a ser aplicada ao controle DataSourceControl.Gets the skin to apply to the DataSourceControl control.

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

SqlCacheDependency

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

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

TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Herdado de Control)
TypeName

Obtém ou define o nome da classe que o objeto ObjectDataSource representa.Gets or sets the name of the class that the ObjectDataSource object represents.

UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(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.Gets or sets the name of the method or function that the ObjectDataSource control invokes to update data.

UpdateParameters

Obtém a coleção de parâmetros que contém os parâmetros usados pelo método especificado pela propriedade UpdateMethod.Gets the parameters collection that contains the parameters that are used by the method that is specified by the UpdateMethod property.

ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

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

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control.

(Herdado de Control)
Visible

Obtém ou define um valor indicando se o controle é exibido visualmente.Gets or sets a value indicating whether the control is visually displayed.

(Herdado de DataSourceControl)

Métodos

AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object.

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

(Herdado de Control)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties that are defined in the page style sheet to the control.

(Herdado de DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data.

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

(Herdado de Control)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.Sets the cached ClientID value to null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls.

(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.Deletes the view-state and control-state information for all the server control's child controls.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to 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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Herdado de Control)
CreateControlCollection()

Cria uma coleção para armazenar controles filho.Creates a collection to store child controls.

(Herdado de DataSourceControl)
DataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.Binds a data source to the invoked server control and all its child controls.

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

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls.

(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.Performs a delete operation by calling the method that is identified by the DeleteMethod property with any parameters that are in the DeleteParameters collection.

Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls.

(Herdado de Control)
EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.Searches the current naming container for a server control with the specified id parameter.

(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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Você não deve substituir esta versão do método FindControl.You should not override this version of the FindControl method.

(Herdado de Control)
Focus()

Define o foco de entrada para o controle.Sets input focus to the control.

(Herdado de DataSourceControl)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.Gets design-time data for a control.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(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.Gets the URL that corresponds to a set of route parameters and a route name.

(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.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Herdado de Control)
GetView(String)

Recupera a exibição da fonte de dados nomeada que está associada ao controle de fonte de dados.Retrieves the named data source view that is associated with the data source control.

GetViewNames()

Recupera uma coleção de nomes que representa a lista de objetos de exibição que estão associados ao objeto ObjectDataSource.Retrieves a collection of names representing the list of view objects that are associated with the ObjectDataSource object.

HasControls()

Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls.

(Herdado de DataSourceControl)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls.

(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.Performs an insert operation by calling the method that is identified by the InsertMethod property and any parameters in the InsertParameters collection.

IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content.

(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().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Herdado de Control)
LoadViewState(Object)

Carrega o estado de exibição salvo anteriormente do controle ObjectDataSource.Loads the previously saved view state of the ObjectDataSource control.

MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

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

(Herdado de Control)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.Raises the DataBinding event.

(Herdado de Control)
OnInit(EventArgs)

Adiciona um manipulador de eventos LoadComplete na página que contém o controle ObjectDataSource.Adds a LoadComplete event handler to the page that contains the ObjectDataSource control.

OnLoad(EventArgs)

Aciona o evento Load.Raises the Load event.

(Herdado de Control)
OnPreRender(EventArgs)

Aciona o evento PreRender.Raises the PreRender event.

(Herdado de Control)
OnUnload(EventArgs)

Aciona o evento Unload.Raises the Unload event.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent.

(Herdado de Control)
RaiseDataSourceChangedEvent(EventArgs)

Aciona o evento DataSourceChanged.Raises the DataSourceChanged event.

(Herdado de DataSourceControl)
RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Herdado de Control)
Render(HtmlTextWriter)

Envia o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Herdado de Control)
RenderChildren(HtmlTextWriter)

Gera o conteúdo de filhos de um controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Herdado de DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Herdado de Control)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client.

(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.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Herdado de Control)
SaveViewState()

Salva o estado do controle ObjectDataSource.Saves the state of the ObjectDataSource control.

Select()

Recupera dados do armazenamento de dados subjacente chamando o método identificado pela propriedade SelectMethod com os parâmetros na coleção SelectParameters.Retrieves data from the underlying data storage by calling the method that is identified by the SelectMethod property with the parameters in the SelectParameters collection.

SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.Sets design-time data for a control.

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

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

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

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

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

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.Performs an update operation by calling the method that is identified by the UpdateMethod property and any parameters that are in the UpdateParameters collection.

Eventos

DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source.

(Herdado de Control)
Deleted

Ocorre quando uma operação Delete() foi concluída.Occurs when a Delete() operation has completed.

Deleting

Ocorre antes de uma operação Delete().Occurs before a Delete() operation.

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

(Herdado de Control)
Filtering

Ocorre antes de uma operação de filtragem.Occurs before a filter operation.

Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Herdado de Control)
Inserted

Ocorre quando uma operação Insert() foi concluída.Occurs when an Insert() operation has completed.

Inserting

Ocorre antes de uma operação de Insert().Occurs before an Insert() operation.

Load

Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object.

(Herdado de Control)
ObjectCreated

Ocorre depois que o objeto identificado pela propriedade TypeName é criado.Occurs after the object that is identified by the TypeName property is created.

ObjectCreating

Ocorre antes que o objeto identificado pela propriedade TypeName é criado.Occurs before the object that is identified by the TypeName property is created.

ObjectDisposing

Ocorre antes que o objeto identificado pela propriedade TypeName seja descartado.Occurs before the object that is identified by the TypeName property is discarded.

PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering.

(Herdado de Control)
Selected

Ocorre quando uma operação Select() foi concluída.Occurs when a Select() operation has completed.

Selecting

Ocorre antes de uma operação Select().Occurs before a Select() operation.

Unload

Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory.

(Herdado de Control)
Updated

Ocorre quando uma operação Update() foi concluída.Occurs when an Update() operation has completed.

Updating

Ocorre antes de uma operação de Update().Occurs before an Update() operation.

Implantações explícitas de interface

IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, consulte ControlBuilder.For a description of this member, see ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, consulte GetDesignModeState().For a description of this member, see GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, consulte SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, consulte SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, consulte UserData.For a description of this member, see UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, consulte DataBindings.For a description of this member, see DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, consulte HasDataBindings.For a description of this member, see HasDataBindings.

(Herdado de Control)
IDataSource.DataSourceChanged

Ocorre quando um controle de fonte de dados foi alterado de forma que afeta controles associados a dados.Occurs when a data source control has changed in a way that affects data-bound controls.

(Herdado de DataSourceControl)
IDataSource.GetView(String)

Obtém um objeto DataSourceView nomeado associado ao controle DataSourceControl.Gets the named DataSourceView object associated with the DataSourceControl control. Alguns controles de fonte de dados dão suporte a apenas uma exibição, enquanto outros dão suporte a mais de uma.Some data source controls support only one view, while others support more than one.

(Herdado de DataSourceControl)
IDataSource.GetViewNames()

Obtém uma coleção de nomes, que representa a lista de objetos DataSourceView associados ao controle DataSourceControl.Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control.

(Herdado de DataSourceControl)
IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, consulte Expressions.For a description of this member, see Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, consulte HasExpressions.For a description of this member, see HasExpressions.

(Herdado de Control)
IListSource.ContainsListCollection

Indica se o controle de fonte de dados está associado a uma ou mais listas de dados.Indicates whether the data source control is associated with one or more lists of data.

(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.Gets a list of data source controls that can be used as sources of lists of data.

(Herdado de DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, consulte AddParsedSubObject(Object).For a description of this member, see 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.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control.

GetDefaultValues(IDataSource)

Obtém a coleção de valores padrão para a fonte de dados especificada.Gets the collection of the default values for the specified data source.

GetMetaTable(IDataSource)

Obtém os metadados para uma tabela no objeto de fonte de dados especificado.Gets the metadata for a table in the specified data source object.

TryGetMetaTable(IDataSource, MetaTable)

Determina se os metadados da tabela estão disponíveis.Determines whether table metadata is available.

Aplica-se a

Veja também