ObjectDataSource Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um objeto comercial que fornece dados a controles com associação de dados em arquiteturas de aplicativo Web multicamadas.
public ref class ObjectDataSource : System::Web::UI::DataSourceControl[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
inherit DataSourceControlPublic Class ObjectDataSource
Inherits DataSourceControl- Herança
- Atributos
Exemplos
Esta seção mostra uma marcação ObjectDataSource in em uma página .aspx e mostra os objetos de negócios com os quais ela funciona. O exemplo é a página .aspx. Ele contém um GridView controle associado a um ObjectDataSource controle . A ObjectDataSource marcação de controle especifica o nome do objeto comercial e o nome do método de objeto comercial a ser chamado para recuperar dados.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1" />
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.CS.EmployeeLogic" />
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - Visual Basic Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1" />
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.VB.EmployeeLogic" />
</form>
</body>
</html>
O exemplo a seguir mostra o objeto de negócios que o ObjectDataSource controle na página .aspx usa. (Muitos outros ObjectDataSource exemplos de código também usam esse objeto de negócios.) O exemplo consiste nas duas seguintes classes básicas:
A
EmployeeLogicclasse é a classe lógica de negócios que o ObjectDataSource usa.A
NorthwindEmployeeclasse define o objeto de dados retornado peloGetAllEmployeesmétodo daEmployeeLogicclasse .
Uma classe adicional NorthwindDataException é fornecida como uma conveniência.
Esse conjunto de classes de exemplo funciona com o banco de dados Northwind Traders, que está disponível com o Microsoft SQL Server e o Microsoft Access. Para obter um exemplo de trabalho completo, você deve compilar e usar essas classes com o exemplo de página .aspx fornecido.
namespace Samples.AspNet.CS {
using System;
using System.Collections;
using System.Collections.Specialized;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
//
// EmployeeLogic is a stateless business object that encapsulates
// the operations one can perform on a NorthwindEmployee object.
//
public class EmployeeLogic {
// Returns a collection of NorthwindEmployee objects.
public static ICollection GetAllEmployees () {
ArrayList al = new ArrayList();
ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];
SqlDataSource sds
= new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");
try {
IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);
// Iterate through the Enumeration and create a
// NorthwindEmployee object for each ID.
foreach (DataRowView row in IDs) {
string id = row["EmployeeID"].ToString();
NorthwindEmployee nwe = new NorthwindEmployee(id);
// Add the NorthwindEmployee object to the collection.
al.Add(nwe);
}
}
finally {
// If anything strange happens, clean up.
sds.Dispose();
}
return al;
}
public static NorthwindEmployee GetEmployee(object anID) {
return new NorthwindEmployee(anID);
}
public static void UpdateEmployeeInfo(NorthwindEmployee ne) {
bool retval = ne.Save();
if (! retval) { throw new NorthwindDataException("UpdateEmployee failed."); }
}
public static void DeleteEmployee(NorthwindEmployee ne) { }
}
public class NorthwindEmployee {
public NorthwindEmployee () {
ID = DBNull.Value;
lastName = "";
firstName = "";
title="";
titleOfCourtesy = "";
reportsTo = -1;
}
public NorthwindEmployee (object anID) {
this.ID = anID;
ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];
SqlConnection conn = new SqlConnection (cts.ConnectionString);
SqlCommand sc =
new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
" FROM Employees " +
" WHERE EmployeeID = @empId",
conn);
// Add the employee ID parameter and set its value.
sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
SqlDataReader sdr = null;
try {
conn.Open();
sdr = sc.ExecuteReader();
// This is not a while loop. It only loops once.
if (sdr != null && sdr.Read()) {
// The IEnumerable contains DataRowView objects.
this.firstName = sdr["FirstName"].ToString();
this.lastName = sdr["LastName"].ToString();
this.title = sdr["Title"].ToString();
this.titleOfCourtesy = sdr["TitleOfCourtesy"].ToString();
if (! sdr.IsDBNull(4)) {
this.reportsTo = sdr.GetInt32(4);
}
}
else {
throw new NorthwindDataException("Data not loaded for employee id.");
}
}
finally {
try {
if (sdr != null) sdr.Close();
conn.Close();
}
catch (SqlException) {
// Log an event in the Application Event Log.
throw;
}
}
}
private object ID;
private string lastName;
public string LastName {
get { return lastName; }
set { lastName = value; }
}
private string firstName;
public string FirstName {
get { return firstName; }
set { firstName = value; }
}
private string title;
public String Title {
get { return title; }
set { title = value; }
}
private string titleOfCourtesy;
public string Courtesy {
get { return titleOfCourtesy; }
set { titleOfCourtesy = value; }
}
private int reportsTo;
public int Supervisor {
get { return reportsTo; }
set { reportsTo = value; }
}
public bool Save () {
return true;
}
}
internal class NorthwindDataException: Exception {
public NorthwindDataException(string msg) : base (msg) { }
}
}
Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
' When the class is written in Visual Basic, you cannot use the Shared
' part.
Public Class EmployeeLogic
' Returns a collection of NorthwindEmployee objects.
Public Shared Function GetAllEmployees() As ICollection
Dim al As New ArrayList()
Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
Try
Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)
' Iterate through the Enumeration and create a
' NorthwindEmployee object for each ID.
For Each row As DataRowView In IDs
Dim id As String = row("EmployeeID").ToString()
Dim nwe As New NorthwindEmployee(id)
' Add the NorthwindEmployee object to the collection.
al.Add(nwe)
Next
Finally
' If anything strange happens, clean up.
sds.Dispose()
End Try
Return al
End Function 'GetAllEmployees
Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
Return New NorthwindEmployee(anID)
End Function 'GetEmployee
Public Shared Sub UpdateEmployeeInfo(ne As NorthwindEmployee)
Dim retval As Boolean = ne.Save()
If Not retval Then
Throw New NorthwindDataException("UpdateEmployee failed.")
End If
End Sub
Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
End Sub
End Class
Public Class NorthwindEmployee
Public Sub New()
ID = DBNull.Value
aLastName = ""
aFirstName = ""
aTitle = ""
titleOfCourtesy = ""
reportsTo = - 1
End Sub
Public Sub New(anID As Object)
Me.ID = anID
Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
Dim conn As New SqlConnection(cts.ConnectionString)
Dim sc As New SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " & _
" FROM Employees " & _
" WHERE EmployeeID = @empId", conn)
' Add the employee ID parameter and set its value.
sc.Parameters.Add(New SqlParameter("@empId", SqlDbType.Int)).Value = Int32.Parse(anID.ToString())
Dim sdr As SqlDataReader = Nothing
Try
conn.Open()
sdr = sc.ExecuteReader()
' This is not a while loop. It only loops once.
If Not (sdr Is Nothing) AndAlso sdr.Read() Then
' The IEnumerable contains DataRowView objects.
Me.aFirstName = sdr("FirstName").ToString()
Me.aLastName = sdr("LastName").ToString()
Me.aTitle = sdr("Title").ToString()
Me.titleOfCourtesy = sdr("TitleOfCourtesy").ToString()
If Not sdr.IsDBNull(4) Then
Me.reportsTo = sdr.GetInt32(4)
End If
Else
Throw New NorthwindDataException("Data not loaded for employee id.")
End If
Finally
Try
If Not (sdr Is Nothing) Then
sdr.Close()
End If
conn.Close()
Catch se As SqlException
' Log an event in the Application Event Log.
Throw
End Try
End Try
End Sub
Private ID As Object
Private aLastName As String
Public Property LastName() As String
Get
Return aLastName
End Get
Set
aLastName = value
End Set
End Property
Private aFirstName As String
Public Property FirstName() As String
Get
Return aFirstName
End Get
Set
aFirstName = value
End Set
End Property
Private aTitle As String
Public Property Title() As String
Get
Return aTitle
End Get
Set
aTitle = value
End Set
End Property
Private titleOfCourtesy As String
Public Property Courtesy() As String
Get
Return titleOfCourtesy
End Get
Set
titleOfCourtesy = value
End Set
End Property
Private reportsTo As Integer
Public Property Supervisor() As Integer
Get
Return reportsTo
End Get
Set
reportsTo = value
End Set
End Property
Public Function Save() As Boolean
Return True
End Function 'Save
End Class
Friend Class NorthwindDataException
Inherits Exception
Public Sub New(msg As String)
MyBase.New(msg)
End Sub
End Class
End Namespace
Comentários
Neste tópico:
Introdução
Um ObjectDataSource controle funciona com uma classe que você cria. Você cria métodos que recuperam e atualizam dados e fornece os nomes desses métodos para o ObjectDataSource controle na marcação. Durante o processamento de renderização ou postback, o chama os ObjectDataSource métodos que você especificou.
Não há renderização visual do ObjectDataSource controle. Como resultado, o não dá suporte a ObjectDataSource recursos visuais, como a EnableTheming propriedade ou SkinID .
Finalidade
Uma prática de design de aplicativo muito comum é separar a camada de apresentação da lógica de negócios e encapsular a lógica de negócios em objetos de negócios. Esses objetos de negócios formam uma camada distinta entre a camada de apresentação e a camada de dados, resultando em uma arquitetura de aplicativo de três camadas. O ObjectDataSource controle permite que os desenvolvedores usem um controle de fonte de dados ASP.NET, mantendo sua arquitetura de aplicativo de três camadas.
O ObjectDataSource controle usa reflexão para criar instâncias de objetos de negócios e chamar métodos neles para recuperar, atualizar, inserir e excluir dados. A TypeName propriedade identifica o nome da classe com a qual o ObjectDataSource funciona. O ObjectDataSource controle cria e destrói uma instância da classe para cada chamada de método; ele não mantém o objeto na memória durante o tempo de vida da solicitação da Web. Essa é uma consideração séria se o objeto de negócios que você usa requer muitos recursos ou, de outra forma, é caro para criar e destruir. Usar um objeto caro pode não ser uma opção de design ideal, mas você pode controlar o ciclo de vida do objeto usando os ObjectCreatingeventos , ObjectCreatede ObjectDisposing .
Observação
Os métodos identificados pelas SelectMethodpropriedades , UpdateMethod, InsertMethode DeleteMethod podem ser métodos de instância ou static (Shared no Visual Basic). Se os métodos forem static (Shared no Visual Basic), uma instância do objeto de negócios não será criada e os ObjectCreatingeventos , ObjectCreatede ObjectDisposing não serão gerados.
Recuperando dados
Para recuperar dados de um objeto de negócios, defina a SelectMethod propriedade como o nome do método que recupera dados. Se o método não retornar um IEnumerable objeto ou DataSet , o objeto será encapsulado pelo runtime em uma coleção IEnumerable . Se a assinatura do método tiver parâmetros, você poderá adicionar Parameter objetos à SelectParameters coleção e associá-los aos valores que você deseja passar para o método especificado pela SelectMethod propriedade . Para que o ObjectDataSource controle use os parâmetros, os parâmetros devem corresponder aos nomes e tipos dos parâmetros na assinatura do método. Para obter mais informações, consulte Usando parâmetros com o controle ObjectDataSource.
O ObjectDataSource controle recupera dados sempre que o Select método é chamado. Esse método fornece acesso programático ao método especificado pela SelectMethod propriedade . O método especificado pela SelectMethod propriedade é chamado automaticamente por controles associados ao ObjectDataSource quando seu DataBind método é chamado. Se você definir a DataSourceID propriedade de um controle associado a dados, o controle será automaticamente associado aos dados da fonte de dados, conforme necessário. Definir a DataSourceID propriedade é o método recomendado para associar um ObjectDataSource controle a um controle associado a dados. Como alternativa, você pode definir a DataSource propriedade , mas, em seguida, você deve chamar explicitamente o DataBind método do controle associado a dados. Você pode chamar o Select método programaticamente a qualquer momento para recuperar dados.
Para obter mais informações sobre como associar controles associados a dados a controles de fonte de dados, consulte Associando a dados usando um controle de fonte de dados.
Executando operações de dados
Dependendo dos recursos do objeto de negócios com o qual o ObjectDataSource controle funciona, você pode executar operações de dados, como atualizações, inserções e exclusões. Para executar essas operações de dados, defina o nome do método apropriado e os parâmetros associados para a operação que você deseja executar. Por exemplo, para uma operação de atualização, defina a UpdateMethod propriedade como o nome do método de objeto comercial que executa atualizações e adicione todos os UpdateParameters parâmetros necessários à coleção. Se o ObjectDataSource controle estiver associado a um controle associado a dados, os parâmetros serão adicionados pelo controle associado a dados. Nesse caso, você precisa garantir que os nomes de parâmetro do método correspondam aos nomes de campo no controle associado a dados. A atualização é executada quando o Update método é chamado, explicitamente pelo código ou automaticamente por um controle associado a dados. O mesmo padrão geral é seguido para Delete as operações e Insert . Supõe-se que os objetos de negócios executem esses tipos de operações de dados um registro por vez, em vez de em lote.
Filtrar dados
O ObjectDataSource controle poderá filtrar os dados recuperados pela SelectMethod propriedade , se os dados forem retornados como um DataSet objeto ou DataTable . Você pode definir a FilterExpression propriedade como uma expressão de filtragem usando uma sintaxe de cadeia de caracteres de formato e associar valores na expressão a parâmetros especificados na FilterParameters coleção.
Cache
Embora o ObjectDataSource não mantenha a instância do objeto de negócios em várias solicitações, ele pode armazenar em cache o resultado da chamada do método identificado pela SelectMethod propriedade . 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 de negócios e chamá-los SelectMethod usando reflexão. O cache permite evitar criar o objeto e chamar seu método de dados em detrimento da memória no servidor Web. O ObjectDataSource armazena dados automaticamente em cache quando a EnableCaching propriedade é definida truecomo e a CacheDuration propriedade é definida como o número de segundos que o cache armazena dados antes que o cache seja descartado. Você também pode especificar uma CacheExpirationPolicy propriedade e uma propriedade opcional SqlCacheDependency . O ObjectDataSource controle permite armazenar em cache todos os tipos de dados, mas você não deve armazenar em cache objetos que retêm recursos ou estado que não podem ser compartilhados para atender a várias solicitações (por exemplo, um objeto aberto SqlDataReader ), porque a mesma instância do objeto será usada para atender a várias solicitações.
Recursos
A tabela a seguir descreve os recursos do ObjectDataSource controle .
| Funcionalidade | Requisitos |
|---|---|
| Seleção | Defina a SelectMethod propriedade como o nome do método de objeto de negócios que seleciona dados e inclua todos os SelectParameters parâmetros necessários na coleção programaticamente ou usando um controle associado a dados. |
| Classificação | Defina a SortParameterName propriedade como o nome do parâmetro no SelectMethod método que carrega os critérios de classificação. |
| Filtragem | Defina a FilterExpression propriedade como 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 retornar um DataSet ou DataTable. |
| Paginamento | Há suporte para paginação de fonte de dados, se o SelectMethod método contiver parâmetros para o número máximo de registros a serem recuperados e o índice do primeiro registro a ser recuperado. Os nomes desses parâmetros devem ser definidos nas MaximumRowsParameterName propriedades e StartRowIndexParameterName , respectivamente. Um controle associado a dados pode ser capaz de executar a paginação em si, mesmo que o ObjectDataSource controle não dê suporte à paginação diretamente no método especificado pela SelectMethod propriedade . O requisito para que o controle associado a dados possa fazer isso é que o método especificado pela SelectMethod propriedade retorne um objeto que implementa a ICollection interface . |
| Atualizar | Defina a UpdateMethod propriedade como o nome do método de objeto comercial que atualiza os dados e inclua os parâmetros necessários na UpdateParameters coleção. |
| Excluir | Defina a DeleteMethod propriedade como o nome do método ou função do objeto comercial que exclui dados e inclua todos os parâmetros necessários na DeleteParameters coleção. |
| Inserindo | Defina a InsertMethod propriedade como o nome do método ou função do objeto comercial que insere dados e inclua os parâmetros necessários na InsertParameters coleção. |
| Cache | Defina a EnableCaching propriedade truecomo e as CacheDuration propriedades e CacheExpirationPolicy de acordo com o comportamento de cache desejado para seus dados armazenados em cache. |
Observação
Quando você usa a ObjectDataSource classe para atualizar ou inserir dados, as cadeias de caracteres inseridas no cliente não são convertidas automaticamente do formato de cultura do cliente para o formato de cultura do servidor. Por exemplo, a cultura do cliente pode especificar DD/MM/AAAA como o formato de data e o formato de data no servidor pode ser MM/DD/AAAA. Nesse caso, 5 de outubro de 2009 seria inserido em um TextBox controle como 10/05/2009, mas seria interpretado como 10 de maio de 2009. 15 de outubro de 2009 seria inserido como 15/10/2009 e seria rejeitado como uma data inválida.
Exibição de dados
Assim como acontece com todos os controles de fonte de dados, o ObjectDataSource controle é associado a uma classe de exibição de fonte de dados. Embora o ObjectDataSource controle seja a interface que o desenvolvedor de página usa para trabalhar com dados, a ObjectDataSourceView classe é a interface com a qual os controles associados a dados funcionam. Além disso, a ObjectDataSourceView classe descreve os recursos do controle da fonte de dados e executa o trabalho real. O ObjectDataSource controle tem apenas um associado ObjectDataSourceViewe é sempre chamado DefaultViewde . Embora o ObjectDataSourceView objeto seja exposto pelo GetView método , muitas de suas propriedades e métodos são encapsulados e expostos diretamente pelo ObjectDataSource controle . Nos bastidores, o ObjectDataSourceView objeto executa todas as operações de dados, incluindo recuperação, inserção, atualização, exclusão, filtragem e classificação dos dados. Para obter mais informações, consulte ObjectDataSourceView.
Usando LINQ to SQL
Você pode usar o ObjectDataSource controle com uma classe LINQ to SQL. Para fazer isso, defina a TypeName propriedade como o nome da classe de contexto de dados. Você também define os SelectMethodmétodos , UpdateMethod, InsertMethode DeleteMethod para os métodos na classe de contexto de dados que executam as operações correspondentes. Você deve criar um manipulador de eventos para o ObjectDisposing evento para cancelar o descarte da classe de contexto de dados. Essa etapa é necessária porque LINQ to SQL dá suporte à execução adiada, enquanto o ObjectDataSource controle tenta descartar o contexto de dados após a operação Selecionar. Para obter mais informações sobre como criar classes LINQ to SQL, consulte Como criar classes LINQ to SQL em um projeto Web. Para obter um exemplo de como cancelar o descarte de uma classe de contexto de dados, consulte o ObjectDisposing evento .
Usando o Entity Framework
Você também pode usar o ObjectDataSource controle com o Entity Framework. Para obter mais informações, consulte Usando o Entity Framework e o controle ObjectDataSource.
Sintaxe declarativa
<asp:ObjectDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
ConflictDetection="OverwriteChanges|CompareAllValues"
ConvertNullToDBNull="True|False"
DataObjectTypeName="string"
DeleteMethod="string"
EnableCaching="True|False"
EnablePaging="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FilterExpression="string"
ID="string"
InsertMethod="string"
MaximumRowsParameterName="string"
OldValuesParameterFormatString="string"
OnDataBinding="DataBinding event handler"
OnDeleted="Deleted event handler"
OnDeleting="Deleting event handler"
OnDisposed="Disposed event handler"
OnFiltering="Filtering event handler"
OnInit="Init event handler"
OnInserted="Inserted event handler"
OnInserting="Inserting event handler"
OnLoad="Load event handler"
OnObjectCreated="ObjectCreated event handler"
OnObjectCreating="ObjectCreating event handler"
OnObjectDisposing="ObjectDisposing event handler"
OnPreRender="PreRender event handler"
OnSelected="Selected event handler"
OnSelecting="Selecting event handler"
OnUnload="Unload event handler"
OnUpdated="Updated event handler"
OnUpdating="Updating event handler"
runat="server"
SelectCountMethod="string"
SelectMethod="string"
SkinID="string"
SortParameterName="string"
SqlCacheDependency="string"
StartRowIndexParameterName="string"
TypeName="string"
UpdateMethod="string"
Visible="True|False"
>
<DeleteParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</DeleteParameters>
<FilterParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</FilterParameters>
<InsertParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</InsertParameters>
<SelectParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</SelectParameters>
<UpdateParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</UpdateParameters>
</asp:ObjectDataSource>
Construtores
| ObjectDataSource() |
Inicializa uma nova instância da classe ObjectDataSource. |
| ObjectDataSource(String, String) |
Inicializa uma nova instância da classe ObjectDataSource com o nome do tipo e o nome do método de recuperação de dados especificados. |
Propriedades
| Adapter |
Obtém o adaptador específico de navegador para o controle. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control) |
| BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control) |
| CacheDuration |
Obtém ou define o período de tempo, em segundos, que o controle de fonte de dados armazena em cache os dados recuperados da propriedade SelectMethod. |
| CacheExpirationPolicy |
Obtém ou define o comportamento de expiração de cache que, quando combinado com a duração, descreve o comportamento do cache usado pelo controle de fonte de dados. |
| CacheKeyDependency |
Obtém ou define uma dependência de chave definida pelo usuário que é vinculada a todos os objetos de cache de dados que são criados pelo controle de fonte de dados. |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o identificador de controle de servidor gerado pelo ASP.NET. (Herdado de DataSourceControl) |
| ClientIDMode |
Essa propriedade não é usada para controles de fonte de dados. (Herdado de DataSourceControl) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control) |
| ConflictDetection |
Obtém ou define um valor que determina se apenas os novos valores são passados para o método |
| Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de DataSourceControl) |
| ConvertNullToDBNull |
Obtém ou define um valor que indica se os valores de Parameter passados para uma operação de atualização, inserção ou exclusão são convertidos automaticamente de |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control) |
| DataObjectTypeName |
Obtém ou define o nome de uma classe que controle o ObjectDataSource usa para um parâmetro em uma atualização, inserção ou exclusão da operação de dados, em vez de passar valores individuais do controle associado a dados. |
| DeleteMethod |
Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para excluir os dados. |
| DeleteParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pelo método DeleteMethod. |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| EnableCaching |
Obtém ou define um valor que indica se o controle ObjectDataSource tem o cache de dados habilitado. |
| EnablePaging |
Obtém ou define um valor que indica se o controle de fonte de dados dá suporte à paginação no conjunto de dados que recupera. |
| EnableTheming |
Obtém um valor que indica se esse controle dá suporte a temas. (Herdado de DataSourceControl) |
| EnableViewState |
Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| FilterExpression |
Obtém ou define uma expressão de filtragem que é aplicada quando o método especificado pela propriedade SelectMethod é chamado. |
| FilterParameters |
Obtém uma coleção de parâmetros associados a espaços reservados para parâmetros na cadeia de caracteres FilterExpression. |
| HasChildViewState |
Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
| InsertMethod |
Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para inserir os dados. |
| InsertParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pela propriedade InsertMethod. |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control) |
| IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control) |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control) |
| MaximumRowsParameterName |
Obtém ou define o nome do parâmetro de método de recuperação de dados do objeto comercial usado para indicar o número de registros a serem recuperados para suporte à paginação de fonte de dados. |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control) |
| OldValuesParameterFormatString |
Obtém ou define uma cadeia de caracteres de formato para aplicar aos nomes dos parâmetros para os valores originais que são passados para os métodos |
| Page |
Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control) |
| ParsingCulture |
Obtém ou define um valor que indica quais informações de cultura são usadas ao converter valores de cadeia de caracteres em tipos de propriedade reais para construir um objeto do tipo indicado por DataObjectTypeName. |
| RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| SelectCountMethod |
Obtém ou define o nome do método ou função invocada pelo controle ObjectDataSource para recuperar uma contagem de linhas. |
| SelectMethod |
Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para recuperar dados. |
| SelectParameters |
Obtém uma coleção de parâmetros que são usados pelo método especificado pela propriedade SelectMethod. |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém a capa a ser aplicada ao controle DataSourceControl. (Herdado de DataSourceControl) |
| SortParameterName |
Obtém ou define o nome do objeto comercial que o parâmetro SelectMethod usou para especificar uma expressão de classificação para suporte à classificação de fonte de dados. |
| SqlCacheDependency |
Obtém ou define uma cadeia de caracteres separada por ponto-e-vírgula que indica quais bancos de dados e tabelas usar para a dependência de cache do Microsoft SQL Server. |
| StartRowIndexParameterName |
Obtém ou define o nome do parâmetro de método de recuperação de dados usado para indicar o valor do identificador do primeiro registro a ser recuperado para o suporte à paginação de fonte de dados. |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control) |
| TypeName |
Obtém ou define o nome da classe que o objeto ObjectDataSource representa. |
| UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control) |
| UpdateMethod |
Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSource para atualizar os dados. |
| UpdateParameters |
Obtém a coleção de parâmetros que contém os parâmetros usados pelo método especificado pela propriedade UpdateMethod. |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control) |
| Visible |
Obtém ou define um valor indicando se o controle é exibido visualmente. (Herdado de DataSourceControl) |
Métodos
| AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria uma coleção para armazenar controles filho. (Herdado de DataSourceControl) |
| DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control) |
| Delete() |
Executa uma operação de exclusão, chamando o método identificado pela propriedade DeleteMethod com os parâmetros que estão na coleção DeleteParameters. |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| Focus() |
Define o foco de entrada para o controle. (Herdado de DataSourceControl) |
| GetDesignModeState() |
Obtém os dados de tempo de design para um controle. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control) |
| GetView(String) |
Recupera a exibição da fonte de dados nomeada que está associada ao controle de fonte de dados. |
| GetViewNames() |
Recupera uma coleção de nomes que representa a lista de objetos de exibição que estão associados ao objeto ObjectDataSource. |
| HasControls() |
Determina se o controle de servidor contém algum controle filho. (Herdado de DataSourceControl) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control) |
| Insert() |
Executa uma operação de inserção chamando o método que é identificado pela propriedade InsertMethod e todos os parâmetros na coleção InsertParameters. |
| IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control) |
| LoadViewState(Object) |
Carrega o estado de exibição salvo anteriormente do controle ObjectDataSource. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnInit(EventArgs) |
Adiciona um manipulador de eventos LoadComplete na página que contém o controle ObjectDataSource. |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender. (Herdado de Control) |
| OnUnload(EventArgs) |
Aciona o evento Unload. (Herdado de Control) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Aciona o evento DataSourceChanged. (Herdado de DataSourceControl) |
| RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control) |
| Render(HtmlTextWriter) |
Envia o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de DataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control) |
| SaveViewState() |
Salva o estado do controle ObjectDataSource. |
| Select() |
Recupera dados do armazenamento de dados subjacente chamando o método identificado pela propriedade SelectMethod com os parâmetros na coleção SelectParameters. |
| SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Controla as alterações de estado de exibição no controle ObjectDataSource, para que elas possam ser armazenadas no objeto StateBag. |
| Update() |
Executa uma operação de atualização chamando o método que é identificado pela propriedade UpdateMethod e os parâmetros que estão na coleção UpdateParameters. |
Eventos
| DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control) |
| Deleted |
Ocorre quando uma operação Delete() foi concluída. |
| Deleting |
Ocorre antes de uma operação Delete(). |
| Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Filtering |
Ocorre antes de uma operação de filtragem. |
| Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control) |
| Inserted |
Ocorre quando uma operação Insert() foi concluída. |
| Inserting |
Ocorre antes de uma operação de Insert(). |
| Load |
Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control) |
| ObjectCreated |
Ocorre depois que o objeto identificado pela propriedade TypeName é criado. |
| ObjectCreating |
Ocorre antes que o objeto identificado pela propriedade TypeName é criado. |
| ObjectDisposing |
Ocorre antes que o objeto identificado pela propriedade TypeName seja descartado. |
| PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
| Selected |
Ocorre quando uma operação Select() foi concluída. |
| Selecting |
Ocorre antes de uma operação Select(). |
| Unload |
Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control) |
| Updated |
Ocorre quando uma operação Update() foi concluída. |
| Updating |
Ocorre antes de uma operação de Update(). |
Implantações explícitas de interface
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control) |
| IDataSource.DataSourceChanged |
Ocorre quando um controle de fonte de dados foi alterado de forma que afeta controles associados a dados. (Herdado de DataSourceControl) |
| IDataSource.GetView(String) |
Obtém um objeto DataSourceView nomeado associado ao controle DataSourceControl. Alguns controles de fonte de dados dão suporte a apenas uma exibição, enquanto outros dão suporte a mais de uma. (Herdado de DataSourceControl) |
| IDataSource.GetViewNames() |
Obtém uma coleção de nomes, que representa a lista de objetos DataSourceView associados ao controle DataSourceControl. (Herdado de DataSourceControl) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control) |
| IListSource.ContainsListCollection |
Indica se o controle de fonte de dados está associado a uma ou mais listas de dados. (Herdado de DataSourceControl) |
| IListSource.GetList() |
Obtém uma lista de controles de fonte de dados que podem ser usados como fontes de listas de dados. (Herdado de DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados. |
| GetDefaultValues(IDataSource) |
Obtém a coleção de valores padrão para a fonte de dados especificada. |
| GetMetaTable(IDataSource) |
Obtém os metadados para uma tabela no objeto de fonte de dados especificado. |
| TryGetMetaTable(IDataSource, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |
Aplica-se a
Confira também
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Passo a passo: associação de dados a um objeto comercial personalizado
- {1>Controles de servidor Web de fonte de dados<1}
- Visão geral do controle ObjectDataSource
- {1>Criando um objeto de origem de controle ObjectDataSource<1}
- Usando o Entity Framework e o controle ObjectDataSource
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de