ObjectDataSource Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um objeto de negócio que fornece dados a controlos vinculados a dados em arquiteturas de aplicações Web multinível.

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

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

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

Public Class ObjectDataSource
Inherits DataSourceControl

Herança: Object

Control

DataSourceControl
ObjectDataSource

Atributos: ToolboxBitmapAttribute

Exemplos

Esta secção mostra uma ObjectDataSource marcação de entrada numa página de .aspx e mostra os objetos de negócio com que funciona. O exemplo é a página .aspx. Contém um GridView controlo que está ligado a um controlo ObjectDataSource . A ObjectDataSource marcação de controlo especifica o nome do objeto de negócio e o nome do método de objeto de negócio a chamar para recuperar os dados.

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

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

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

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

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

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

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

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

O exemplo seguinte mostra o objeto de negócio que o ObjectDataSource controlo na página de .aspx utiliza. (Muitos outros ObjectDataSource exemplos de código também utilizam este objeto de negócio.) O exemplo consiste nas seguintes duas classes básicas:

A EmployeeLogic classe é a classe de lógica de negócio que utiliza ObjectDataSource .
A NorthwindEmployee classe define o objeto de dados que é devolvido pelo GetAllEmployees método da EmployeeLogic classe.

É oferecida uma aula adicional NorthwindDataException por conveniência.

Este conjunto de classes de exemplo funciona com a base de dados Northwind Traders, que está disponível com Microsoft SQL Server e Microsoft Access. Para um exemplo completo e funcional, deve compilar e usar estas classes com o exemplo de .aspx página fornecido.

namespace Samples.AspNet.CS {

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

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

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

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

      try {

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

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

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

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

    public static void DeleteEmployee(NorthwindEmployee ne) { }
  }

  public class NorthwindEmployee {

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

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

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

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

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

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

    private object ID;

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

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

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

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

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

    public bool Save () {
      return true;
    }
  }

  internal class NorthwindDataException: Exception {
    public NorthwindDataException(string msg) : base (msg) { }
  }
}

Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls

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

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

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

      Return al
   End Function 'GetAllEmployees

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


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

   Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
   End Sub

End Class


Public Class NorthwindEmployee


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


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

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

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

   Private ID As Object

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

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

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

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

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

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


Friend Class NorthwindDataException
   Inherits Exception

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

Observações

Neste tópico:

Introdução
Objetivo
Recuperação de Dados
Realização de Operações de Dados
Filtragem de dados
Caching
Features
Visualização de dados
Usar LINQ para SQL
Sintaxe declarativa

Introduction

Um ObjectDataSource controlo funciona com uma classe que tu crias. Crias métodos que recuperam e atualizam dados, e forneces os nomes desses métodos ao ObjectDataSource controlo na marcação. Durante o processamento de renderização ou pós-retorno, chamam ObjectDataSource os métodos que especificaste.

Não há renderização visual do ObjectDataSource controlo. Como resultado, não ObjectDataSource suporta funcionalidades visuais como a EnableTheming propriedade ou.SkinID

Purpose

Uma prática muito comum de design de aplicações é separar a camada de apresentação da lógica de negócio e encapsular a lógica de negócio em objetos de negócio. Estes objetos de negócio formam uma camada distinta entre a camada de apresentação e a camada de dados, resultando numa arquitetura de aplicação de três camadas. O controlo ObjectDataSource permite aos programadores usar um controlo de fonte de dados ASP.NET, mantendo a sua arquitetura de aplicação em três níveis.

O ObjectDataSource controlo utiliza reflexão para criar instâncias de objetos de negócio e para chamar métodos neles para recuperar, atualizar, inserir e eliminar dados. A TypeName propriedade identifica o nome da classe com a qual trabalha ObjectDataSource . O ObjectDataSource controlo cria e destrói uma instância da classe para cada chamada de método; não mantém o objeto em memória durante toda a vida útil do pedido Web. Isto é uma consideração séria se o objeto de negócio que utiliza requer muitos recursos ou for caro de criar e destruir. Usar um objeto caro pode não ser uma escolha de design ótima, mas pode controlar o ciclo de vida do objeto usando os ObjectCreating, ObjectCreated, e ObjectDisposing eventos.

Note

Os métodos identificados pelas propriedades SelectMethod, UpdateMethod, InsertMethod e DeleteMethod podem ser métodos de instância ou métodos static (Shared em Visual Basic). Se os métodos forem static (Shared em Visual Basic), não é criada uma instância do objeto de negócio, e os eventos ObjectCreating, ObjectCreated e ObjectDisposing não são levantados.

Recuperando dados

Para recuperar dados de um objeto de negócio, defina a SelectMethod propriedade para o nome do método que recupera os dados. Se o método não devolver um IEnumerable objeto ou DataSet , o objeto é enrolado pelo tempo de execução numa IEnumerable coleção. Se a assinatura do método tiver parâmetros, podes adicionar Parameter objetos à SelectParameters coleção e depois associá-los aos valores que queres passar ao método especificado pela SelectMethod propriedade. Para que o ObjectDataSource controlo utilize os parâmetros, estes devem corresponder aos nomes e tipos dos parâmetros na assinatura do método. Para mais informações, consulte Utilização de Parâmetros com o Controlo ObjectDataSource.

O ObjectDataSource controlo recupera dados sempre que o Select método é chamado. Este método fornece acesso programático ao método especificado pela SelectMethod propriedade. O método especificado pela SelectMethod propriedade é chamado automaticamente por controlos que estão ligados ao ObjectDataSource quando o seu DataBind método é chamado. Se definir a DataSourceID propriedade de um controlo data-bound, o controlo liga-se automaticamente aos dados da fonte de dados, conforme necessário. Definir a DataSourceID propriedade é o método recomendado para ligar um ObjectDataSource controlo a um controlo ligado a dados. Em alternativa, pode definir a DataSource propriedade, mas depois deve chamar explicitamente o DataBind método do controlo data-bound. Pode chamar o Select método programaticamente a qualquer momento para recuperar dados.

Para mais informações sobre como ligar controlos de dados vinculados a controlos de fonte de dados, consulte Binding to Data Using a Data Source Control.

Realização de Operações de Dados

Dependendo das capacidades do objeto de negócio com que o ObjectDataSource controlo trabalha, pode realizar operações de dados, como atualizações, inserções e eliminações. Para realizar estas operações de dados, defina o nome do método apropriado e quaisquer parâmetros associados para a operação que pretende realizar. Por exemplo, para uma operação de atualização, defina a UpdateMethod propriedade para o nome do método de objeto de negócio que realiza as atualizações e adicione quaisquer parâmetros necessários à UpdateParameters coleção. Se o controlo ObjectDataSource estiver associado a um controlo limitado por dados, os parâmetros são adicionados pelo controlo limitado por dados. Neste caso, é necessário garantir que os nomes dos parâmetros do método correspondem aos nomes dos campos no controlo data-bound. A atualização é realizada quando o Update método é chamado, seja explicitamente pelo seu código ou automaticamente por um controlo ligado a dados. Segue-se o mesmo padrão geral para Delete as operações e Insert and. Assume-se que os objetos de negócio realizam este tipo de operações de dados um registo de cada vez, em vez de agrupados.

Filtrando dados

O ObjectDataSource controlo pode filtrar os dados que são recuperados pela SelectMethod propriedade, se os dados forem devolvidos como um DataSet objeto ou DataTable . Pode definir a FilterExpression propriedade para uma expressão de filtragem usando uma sintaxe de string de formato e associar valores na expressão a parâmetros especificados na FilterParameters coleção.

Caching

Embora não ObjectDataSource retenha a instância do objeto de negócio através de múltiplos pedidos, pode armazenar em cache o resultado de chamar o método identificado pela SelectMethod propriedade. Enquanto os dados estão armazenados em cache, chamadas subsequentes ao Select método retornam os dados em cache em vez de criar o objeto de negócio e chamá-lo SelectMethod usando reflection. A cache permite-lhe evitar criar o objeto e chamar o seu método de dados à custa da memória no servidor Web. A ObjectDataSource cache automaticamente coloca os dados quando a EnableCaching propriedade está definida para true, e a CacheDuration propriedade é definida para o número de segundos em que a cache armazena dados antes de ser descartada. Também pode especificar uma CacheExpirationPolicy propriedade e uma propriedade opcional SqlCacheDependency . O ObjectDataSource controlo permite-lhe armazenar em cache todos os tipos de dados, mas não deve armazenar em cache objetos que retenham recursos ou estados que não possam ser partilhados para servir múltiplos pedidos (por exemplo, um objeto aberto SqlDataReader ), porque a mesma instância do objeto será usada para servir múltiplos pedidos.

Features

A tabela seguinte descreve as funcionalidades do ObjectDataSource controlo.

Capability	Requirements
Seleção	Defina a SelectMethod propriedade para o nome do método de objeto de negócio que seleciona os dados, e inclua quaisquer parâmetros necessários na SelectParameters coleção, seja programaticamente ou usando um controlo de dados limitado.
Ordenação	Defina a SortParameterName propriedade para o nome do parâmetro no SelectMethod método que transporta os critérios de ordenação.
Filtragem	Defina a FilterExpression propriedade para uma expressão de filtragem e, opcionalmente, adicione quaisquer parâmetros à FilterParameters coleção para filtrar os dados quando o Select método for chamado. O método especificado pela SelectMethod propriedade deve devolver um DataSet ou DataTable.
Paging	A paginação da fonte de dados é suportada se o SelectMethod método contiver parâmetros para o número máximo de registos a recuperar e o índice do primeiro registo a recuperar. Os nomes desses parâmetros devem ser definidos nas MaximumRowsParameterName propriedades e StartRowIndexParameterName , respetivamente. Um controlo data-bound pode ser capaz de realizar a paginação por si próprio, mesmo que o controlo ObjectDataSource não suporte paginação diretamente no método especificado pela SelectMethod propriedade. O requisito para que o controlo data-bound consiga fazer isto é que o método especificado pela SelectMethod propriedade devolva um objeto que implemente a ICollection interface.
Atualização	Defina a UpdateMethod propriedade para o nome do método de objeto de negócio que atualiza os dados e inclua quaisquer parâmetros necessários na UpdateParameters coleção.
Apagar	Defina a DeleteMethod propriedade para o nome do objeto de negócio, método ou função que elimina os dados, e inclua quaisquer parâmetros necessários na DeleteParameters coleção.
Inserção	Defina a InsertMethod propriedade para o nome do objeto de negócio, método ou função que insere dados e inclua quaisquer parâmetros necessários na InsertParameters coleção.
Caching	Defina a EnableCaching propriedade para `true`, e as CacheDuration propriedades e CacheExpirationPolicy de acordo com o comportamento de cache que pretende para os seus dados em cache.

Note

Quando usa a ObjectDataSource classe para atualizar ou inserir dados, as strings inseridas no cliente não são automaticamente convertidas do formato de cultura do cliente para o formato de cultura do servidor. Por exemplo, a cultura do cliente pode especificar DD/MM/YYYY como formato de data, e o formato de data no servidor pode ser MM/DD/YYYY. Nesse caso, 5 de outubro de 2009 seria registado num TextBox controlo como 10/05/2009, mas seria interpretado como 10 de maio de 2009. 15 de outubro de 2009 seria registado como 15/10/2009 e seria rejeitado como data inválida.

Vista de Dados

Como em todos os controlos de fonte de dados, o controlo ObjectDataSource está associado a uma classe de vista de fonte de dados. Enquanto o ObjectDataSource controlo é a interface que o programador da página usa para trabalhar com dados, a ObjectDataSourceView classe é a interface com que os controlos vinculados a dados trabalham. Adicionalmente, a ObjectDataSourceView classe descreve as capacidades do controlo de fonte de dados e realiza o trabalho real. O ObjectDataSource controlo tem apenas um associado ObjectDataSourceView, e é sempre chamado DefaultView. Enquanto o ObjectDataSourceView objeto é exposto pelo GetView método, muitas das suas propriedades e métodos são envolvidos e expostos diretamente pelo ObjectDataSource controlo. Nos bastidores, o ObjectDataSourceView objeto realiza todas as operações de dados, incluindo a recuperação, inserção, atualização, eliminação, filtragem e ordenação dos dados. Para obter mais informações, veja ObjectDataSourceView.

Usar LINQ para SQL

Podes usar o ObjectDataSource controlo com uma classe LINQ para SQL. Para isso, defines a TypeName propriedade para o nome da classe data-context. Também define os SelectMethodmétodos , UpdateMethod, InsertMethod, e DeleteMethod para os métodos da classe de contexto de dados que realizam as operações correspondentes. Deve criar um gestor de eventos para o ObjectDisposing evento para cancelar a eliminação da classe de contexto de dados. Este passo é necessário porque o LINQ para SQL suporta execução diferida, enquanto o controlo ObjectDataSource tenta eliminar o contexto dos dados após a operação Select. Para mais informações sobre como criar classes LINQ para SQL, consulte Como: Criar Classes LINQ para SQL numa Web Project. Para um exemplo de como cancelar a eliminação de uma classe de contexto de dados, veja o ObjectDisposing evento.

Utilização do Entity Framework

Também pode usar o ObjectDataSource controlo com o Entity Framework. Para mais informações, consulte Utilização do Entity Framework e do Controlo ObjectDataSource.

Sintaxe declarativa

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

Construtores

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

Propriedades

Name	Description
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
CacheDuration	Obtém ou define o tempo, em segundos, em que o controlo de fonte de dados armazena em cache dados que são recuperados pela SelectMethod propriedade.
CacheExpirationPolicy	Obtém ou define o comportamento de expiração da cache que, quando combinado com a duração, descreve o comportamento da cache que o controlo de fonte de dados utiliza.
CacheKeyDependency	Obtém ou define uma dependência de chave definida pelo utilizador que está ligada a todos os objetos de cache de dados criados pelo controlo de fonte de dados.
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ClientID	Obtém o identificador de controlo do servidor gerado pelo ASP.NET. (Herdado de DataSourceControl)
ClientIDMode	Esta propriedade não é usada para controlos de fonte de dados. (Herdado de DataSourceControl)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
ConflictDetection	Recebe ou define um valor que determina se apenas os novos valores são passados ao `Update` método ou se ambos os valores antigos e novos são passados ao `Update` método.
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface. (Herdado de DataSourceControl)
ConvertNullToDBNull	Recebe ou define um valor que indica se os Parameter valores que são passados para uma operação de atualização, inserção ou eliminação são automaticamente convertidos para `null` o Value valor pelo ObjectDataSource controlo.
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DataObjectTypeName	Recebe ou define o nome de uma classe que o ObjectDataSource controlo usa para um parâmetro numa operação de atualização, inserção ou eliminação de dados, em vez de passar valores individuais do controlo ligado aos dados.
DeleteMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controlo invoca para eliminar dados.
DeleteParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo DeleteMethod método.
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
EnableCaching	Recebe ou define um valor que indica se o controlo ObjectDataSource tem a cache de dados ativada.
EnablePaging	Recebe ou define um valor que indica se o controlo de fonte de dados suporta a paginação através do conjunto de dados que recupera.
EnableTheming	Recebe um valor que indica se este controlo suporta temas. (Herdado de DataSourceControl)
EnableViewState	Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
FilterExpression	Obtém ou define uma expressão de filtragem que é aplicada quando o método especificado pela SelectMethod propriedade é chamado.
FilterParameters	Obtém uma coleção de parâmetros associados a quaisquer marcadores de parâmetros na FilterExpression cadeia.
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
ID	Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control)
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
InsertMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controlo invoca para inserir dados.
InsertParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pela InsertMethod propriedade.
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
MaximumRowsParameterName	Obtém ou define o nome do parâmetro do método de recuperação de dados do objeto de negócio que é usado para indicar o número de registos a recuperar para suporte à paginação da fonte de dados.
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
OldValuesParameterFormatString	Obtém ou define uma cadeia de formatos para aplicar aos nomes dos parâmetros dos valores originais que são passados para os `Delete` métodos ou `Update` .
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
ParsingCulture	Obtém um ou define um valor que indica que informação de cultura é usada ao converter valores de cadeia em tipos de propriedade reais para construir um objeto do tipo indicado por DataObjectTypeName.
RenderingCompatibility	Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
SelectCountMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controlo invoca para recuperar uma contagem de linhas.
SelectMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controlo invoca para recuperar dados.
SelectParameters	Obtém uma coleção de parâmetros que são usados pelo método especificado pela SelectMethod propriedade.
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SkinID	Faz com que a pele se aplique ao DataSourceControl controlo. (Herdado de DataSourceControl)
SortParameterName	Obtém ou define o nome do objeto de negócio que o SelectMethod parâmetro é usado para especificar uma expressão de ordenação para suporte à ordenação de fontes de dados.
SqlCacheDependency	Obtém ou define uma cadeia delimitada por ponto e vírgula que indica quais bases de dados e tabelas usar para a dependência da cache do Microsoft SQL Server.
StartRowIndexParameterName	Obtém ou define o nome do parâmetro do método de recuperação de dados que é usado para indicar o valor do identificador do primeiro registo a recuperar para suporte à paginação da fonte de dados.
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
TypeName	Recebe ou define o nome da classe que o ObjectDataSource objeto representa.
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
UpdateMethod	Obtém ou define o nome do método ou função que o ObjectDataSource controlo invoca para atualizar os dados.
UpdateParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método especificado pela UpdateMethod propriedade.
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
Visible	Recebe ou define um valor que indica se o controlo é visualmente exibido. (Herdado de DataSourceControl)

Métodos

Name	Description
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
CreateChildControls()	Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização. (Herdado de Control)
CreateControlCollection()	Cria uma coleção para armazenar controlos filhos. (Herdado de DataSourceControl)
DataBind()	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de Control)
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
Delete()	Realiza uma operação de eliminação chamando o método identificado pela DeleteMethod propriedade com quaisquer parâmetros que estejam na DeleteParameters coleção.
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureID()	Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de DataSourceControl)
Focus()	Define o foco de entrada no controlo. (Herdado de DataSourceControl)
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
GetView(String)	Recupera a vista da fonte de dados nomeada associada ao controlo de fonte de dados.
GetViewNames()	Recupera uma coleção de nomes que representam a lista de objetos de vista associados ao ObjectDataSource objeto.
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de DataSourceControl)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
Insert()	Realiza uma operação de inserção chamando o método identificado pela InsertMethod propriedade e por quaisquer parâmetros na InsertParameters coleção.
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Carrega o estado de visualização previamente guardado do ObjectDataSource controlo.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control)
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnInit(EventArgs)	Adiciona um LoadComplete gestor de eventos à página que contém o ObjectDataSource controlo.
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Eleva o PreRender evento. (Herdado de Control)
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RaiseDataSourceChangedEvent(EventArgs)	Eleva o DataSourceChanged evento. (Herdado de DataSourceControl)
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Envia conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de DataSourceControl)
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control)
SaveViewState()	Poupa o estado do ObjectDataSource controlo.
Select()	Recupera dados do armazenamento subjacente chamando o método identificado pela SelectMethod propriedade com os parâmetros na SelectParameters coleção.
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Regista alterações de estado de visualização no ObjectDataSource controlo para que possam ser armazenadas no StateBag objeto.
Update()	Realiza uma operação de atualização chamando o método identificado pela UpdateMethod propriedade e quaisquer parâmetros que estejam na UpdateParameters coleção.

evento

Name	Description
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
Deleted	Ocorre quando uma Delete() operação é concluída.
Deleting	Ocorre antes de uma Delete() operação.
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Filtering	Ocorre antes de uma operação de filtragem.
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
Inserted	Ocorre quando uma Insert() operação é concluída.
Inserting	Ocorre antes de uma Insert() operação.
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
ObjectCreated	Ocorre depois de o objeto identificado pela TypeName propriedade ser criado.
ObjectCreating	Ocorre antes de o objeto identificado pela TypeName propriedade ser criado.
ObjectDisposing	Ocorre antes de o objeto identificado pela TypeName propriedade ser descartado.
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
Selected	Ocorre quando uma Select() operação é concluída.
Selecting	Ocorre antes de uma Select() operação.
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)
Updated	Ocorre quando uma Update() operação é concluída.
Updating	Ocorre antes de uma Update() operação.

Implementações de Interface Explícita

Name	Description
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IDataSource.DataSourceChanged	Ocorre quando um controlo de fonte de dados mudou de forma a afetar os controlos vinculados aos dados. (Herdado de DataSourceControl)
IDataSource.GetView(String)	Obtém o objeto nomeado DataSourceView associado ao DataSourceControl controlo. Alguns controlos de fonte de dados suportam apenas uma vista, enquanto outros suportam mais do que uma. (Herdado de DataSourceControl)
IDataSource.GetViewNames()	Obtém uma coleção de nomes, representando a lista de DataSourceView objetos associados ao DataSourceControl controlo. (Herdado de DataSourceControl)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IListSource.ContainsListCollection	Indica se o controlo de fonte de dados está associado a uma ou mais listas de dados. (Herdado de DataSourceControl)
IListSource.GetList()	Obtém uma lista de controlos de fonte de dados que podem ser usados como fontes de listas de dados. (Herdado de DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)

Métodos da Extensão

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

Aplica-se a

Ver também

Comentários

Esta página foi útil?