ObjectDataSource Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un objeto comercial que proporciona datos a los controles enlazados a datos en las arquitecturas de aplicaciones Web multi-nivel.
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- Herencia
- Atributos
Ejemplos
En esta sección se muestra un ObjectDataSource en el marcado de una página .aspx y se muestran los objetos empresariales con los que funciona. El ejemplo es la página .aspx. Contiene un GridView control enlazado a un ObjectDataSource control . El ObjectDataSource marcado de control especifica el nombre del objeto de negocio y el nombre del método de objeto de negocio al que se va a llamar para recuperar datos.
<%@ 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>
En el ejemplo siguiente se muestra el objeto de negocio que usa el ObjectDataSource control en la página .aspx. (Muchos otros ObjectDataSource ejemplos de código también usan este objeto de negocio). El ejemplo consta de las dos clases básicas siguientes:
La
EmployeeLogicclase es la clase lógica de negocios que ObjectDataSource usa .La
NorthwindEmployeeclase define el objeto de datos devuelto por elGetAllEmployeesmétodo de laEmployeeLogicclase .
Se proporciona una clase adicional NorthwindDataException como comodidad.
Este conjunto de clases de ejemplo funciona con la base de datos Northwind Traders, que está disponible con Microsoft SQL Server y Microsoft Access. Para obtener un ejemplo de trabajo completo, debe compilar y usar estas clases con el ejemplo de página .aspx que se proporciona.
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
Comentarios
En este tema:
Introducción
Un ObjectDataSource control funciona con una clase que se crea. Los métodos que se recuperan y actualizan los datos, y se proporcionan los nombres de esos métodos al control en el ObjectDataSource marcado. Durante la representación o el procesamiento de postback, ObjectDataSource llama a los métodos especificados.
No hay ninguna representación visual del ObjectDataSource control. Como resultado, no ObjectDataSource admite características visuales como la EnableTheming propiedad o SkinID .
Propósito
Una práctica de diseño de aplicaciones muy común es separar la capa de presentación de la lógica de negocios y encapsular la lógica de negocios en objetos de negocios. Estos objetos empresariales forman una capa distinta entre la capa de presentación y la capa de datos, lo que da lugar a una arquitectura de aplicación de tres niveles. El ObjectDataSource control permite a los desarrolladores usar un control de origen de datos ASP.NET a la vez que conservan su arquitectura de aplicación de tres niveles.
El ObjectDataSource control usa la reflexión para crear instancias de objetos empresariales y llamar a métodos en ellos para recuperar, actualizar, insertar y eliminar datos. La TypeName propiedad identifica el nombre de la clase con la ObjectDataSource que funciona . El ObjectDataSource control crea y destruye una instancia de la clase para cada llamada de método; no contiene el objeto en memoria durante la vigencia de la solicitud web. Se trata de una consideración seria si el objeto de negocio que usa requiere muchos recursos o es costoso crear y destruir. El uso de un objeto costoso podría no ser una opción de diseño óptima, pero puede controlar el ciclo de vida del objeto mediante los ObjectCreatingeventos , ObjectCreatedy ObjectDisposing .
Nota
Los métodos identificados por las SelectMethodpropiedades , UpdateMethod, InsertMethody DeleteMethod pueden ser métodos de instancia o static (Shared en Visual Basic). Si los métodos son static (Shared en Visual Basic), no se crea una instancia del objeto de negocio y no se generan los ObjectCreatingeventos , ObjectCreatedy ObjectDisposing .
Recuperación de datos
Para recuperar datos de un objeto de negocio, establezca la SelectMethod propiedad en el nombre del método que recupera datos. Si el método no devuelve un IEnumerable objeto o DataSet , el tiempo de ejecución en una IEnumerable colección ajusta el objeto . Si la firma del método tiene parámetros, puede agregar Parameter objetos a la SelectParameters colección y, a continuación, enlazarlos a los valores que desea pasar al método especificado por la SelectMethod propiedad . Para que el ObjectDataSource control use los parámetros, los parámetros deben coincidir con los nombres y tipos de los parámetros en la firma del método. Para obtener más información, vea Usar parámetros con el control ObjectDataSource.
El ObjectDataSource control recupera datos cada vez que se llama al Select método . Este método proporciona acceso mediante programación al método especificado por SelectMethod la propiedad . Los controles que están enlazados al método cuando se llama a su DataBind método se llaman automáticamente a ObjectDataSource los métodos especificados por la SelectMethod propiedad . Si establece la DataSourceID propiedad de un control enlazado a datos, el control se enlaza automáticamente a los datos del origen de datos, según sea necesario. Establecer la DataSourceID propiedad es el método recomendado para enlazar un ObjectDataSource control a un control enlazado a datos. Como alternativa, puede establecer la DataSource propiedad , pero después debe llamar explícitamente al DataBind método del control enlazado a datos. Puede llamar al Select método mediante programación en cualquier momento para recuperar datos.
Para obtener más información sobre cómo enlazar controles enlazados a datos a controles de origen de datos, vea Enlace a datos mediante un control de origen de datos.
Realización de operaciones de datos
En función de las funcionalidades del objeto de negocio con el que funciona el ObjectDataSource control, puede realizar operaciones de datos, como actualizaciones, inserciones y eliminaciones. Para realizar estas operaciones de datos, establezca el nombre del método adecuado y los parámetros asociados para la operación que desea realizar. Por ejemplo, para una operación de actualización, establezca la UpdateMethod propiedad en el nombre del método de objeto de negocio que realiza actualizaciones y agregue los parámetros necesarios a la UpdateParameters colección. Si el ObjectDataSource control está asociado a un control enlazado a datos, el control enlazado a datos agrega los parámetros. En este caso, debe asegurarse de que los nombres de parámetro del método coincidan con los nombres de campo del control enlazado a datos. La actualización se realiza cuando se llama al Update método, ya sea explícitamente por el código o automáticamente por un control enlazado a datos. Se sigue el mismo patrón general para Delete las operaciones y Insert . Se supone que los objetos empresariales realizan estos tipos de operaciones de datos de un registro a la vez, en lugar de por lotes.
Filtrado de datos
El ObjectDataSource control puede filtrar los datos recuperados por la SelectMethod propiedad , si los datos se devuelven como un DataSet objeto o DataTable . Puede establecer la FilterExpression propiedad en una expresión de filtrado mediante una sintaxis de cadena de formato y enlazar valores de la expresión a parámetros especificados en la FilterParameters colección.
Almacenamiento en memoria caché
ObjectDataSource Aunque no conserva la instancia del objeto de negocio en varias solicitudes, puede almacenar en caché el resultado de llamar al método identificado por la SelectMethod propiedad . Mientras los datos se almacenan en caché, las llamadas posteriores al Select método devuelven los datos almacenados en caché en lugar de crear el objeto de negocio y llamar a mediante SelectMethod reflexión. El almacenamiento en caché permite evitar crear el objeto y llamar a su método de datos a costa de la memoria en el servidor web. Almacena ObjectDataSource automáticamente en caché los datos cuando la EnableCaching propiedad se establece trueen y la CacheDuration propiedad se establece en el número de segundos que la memoria caché almacena los datos antes de que se descarte la memoria caché. También puede especificar una CacheExpirationPolicy propiedad y una propiedad opcional SqlCacheDependency . El ObjectDataSource control permite almacenar en caché todos los tipos de datos, pero no debe almacenar en caché los objetos que conservan los recursos o el estado que no se pueden compartir para atender varias solicitudes (por ejemplo, un objeto abierto SqlDataReader ), ya que la misma instancia del objeto se usará para atender varias solicitudes.
Características
En la tabla siguiente se describen las características del ObjectDataSource control .
| Funcionalidad | Requisitos |
|---|---|
| Seleccionar | Establezca la SelectMethod propiedad en el nombre del método de objeto de negocio que selecciona los datos e incluya los parámetros necesarios en la SelectParameters colección mediante programación o mediante un control enlazado a datos. |
| Ordenar | Establezca la SortParameterName propiedad en el nombre del parámetro en el SelectMethod método que contiene los criterios de ordenación. |
| Filtros | Establezca la FilterExpression propiedad en una expresión de filtrado y, opcionalmente, agregue los parámetros a la FilterParameters colección para filtrar los datos cuando se llama al Select método . El método especificado por la SelectMethod propiedad debe devolver o DataSetDataTable. |
| Paginación | Se admite la paginación del origen de datos, si el SelectMethod método contiene parámetros para el número máximo de registros que se van a recuperar y el índice del primer registro que se va a recuperar. Los nombres de esos parámetros deben establecerse en las MaximumRowsParameterName propiedades y StartRowIndexParameterName , respectivamente. Es posible que un control enlazado a datos pueda realizar la paginación, incluso si el ObjectDataSource control no admite la paginación directamente en el método especificado por la SelectMethod propiedad . El requisito para que el control enlazado a datos pueda hacerlo es que el método especificado por la SelectMethod propiedad devuelve un objeto que implementa la ICollection interfaz . |
| Actualizando | Establezca la UpdateMethod propiedad en el nombre del método de objeto de negocio que actualiza los datos e incluya los parámetros necesarios en la UpdateParameters colección. |
| Eliminando | Establezca la DeleteMethod propiedad en el nombre del método o función del objeto de negocio que elimina los datos e incluya los parámetros necesarios en la DeleteParameters colección. |
| Inserción | Establezca la InsertMethod propiedad en el nombre del método o función del objeto de negocio que inserta datos e incluya los parámetros necesarios en la InsertParameters colección. |
| Almacenamiento en memoria caché | Establezca la EnableCaching propiedad trueen y las CacheDuration propiedades y CacheExpirationPolicy según el comportamiento de almacenamiento en caché que desee para los datos almacenados en caché. |
Nota
Cuando se usa la ObjectDataSource clase para actualizar o insertar datos, las cadenas que se escriben en el cliente no se convierten automáticamente del formato de referencia cultural del cliente al formato de referencia cultural del servidor. Por ejemplo, la referencia cultural del cliente podría especificar DD/MM/AAAA como formato de fecha y el formato de fecha en el servidor podría ser MM/DD/AAAA. En ese caso, el 5 de octubre de 2009 se introduciría en un TextBox control como 10/5/2009, pero se interpretaría como 10 de mayo de 2009. El 15 de octubre de 2009 se especificaría como 15/10/2009 y se rechazaría como fecha no válida.
Vista de datos
Al igual que con todos los controles de origen de datos, el ObjectDataSource control está asociado a una clase de vista del origen de datos. Aunque el ObjectDataSource control es la interfaz con la que el desarrollador de páginas usa para trabajar con datos, la ObjectDataSourceView clase es la interfaz con la que funcionan los controles enlazados a datos. Además, la ObjectDataSourceView clase describe las funcionalidades del control de origen de datos y realiza el trabajo real. El ObjectDataSource control solo tiene un asociado ObjectDataSourceViewy siempre se denomina DefaultView. Mientras el método expone GetView el ObjectDataSourceView objeto , muchas de sus propiedades y métodos se encapsulan y exponen directamente mediante el ObjectDataSource control . En segundo plano, el ObjectDataSourceView objeto realiza todas las operaciones de datos, incluida la recuperación, inserción, actualización, eliminación, filtrado y ordenación de los datos. Para obtener más información, vea ObjectDataSourceView.
Uso de LINQ to SQL
Puede usar el ObjectDataSource control con una clase LINQ to SQL. Para ello, establezca la TypeName propiedad en el nombre de la clase de contexto de datos. También se establecen los SelectMethodmétodos , UpdateMethod, InsertMethody DeleteMethod en los métodos de la clase de contexto de datos que realizan las operaciones correspondientes. Debe crear un controlador de eventos para el ObjectDisposing evento para cancelar la eliminación de la clase de contexto de datos. Este paso es necesario porque LINQ to SQL admite la ejecución diferida, mientras que el ObjectDataSource control intenta eliminar el contexto de datos después de la operación Select. Para obtener más información sobre cómo crear clases de LINQ to SQL, vea How to: Create LINQ to SQL Classes in a Web Project. Para obtener un ejemplo de cómo cancelar la eliminación de una clase de contexto de datos, vea el ObjectDisposing evento .
Uso de Entity Framework
También puede usar el ObjectDataSource control con Entity Framework. Para obtener más información, vea Uso de Entity Framework y el control ObjectDataSource.
Sintaxis 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>
Constructores
| ObjectDataSource() |
Inicializa una nueva instancia de la clase ObjectDataSource. |
| ObjectDataSource(String, String) |
Inicializa una instancia nueva de la clase ObjectDataSource con el nombre del tipo y el nombre del método de recuperación de datos especificados. |
Propiedades
| Adapter |
Obtiene el adaptador específico del explorador para el control. (Heredado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Heredado de Control) |
| BindingContainer |
Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control) |
| CacheDuration |
Obtiene o establece el período de tiempo, en segundos, que el control de origen de datos almacena en memoria caché los datos recuperados por la propiedad SelectMethod. |
| CacheExpirationPolicy |
Obtiene o establece el comportamiento de expiración de la memoria caché que, combinado con la duración, describe el comportamiento de almacenamiento en caché que usa el control de origen de datos. |
| CacheKeyDependency |
Obtiene o establece una dependencia de clave definida por el usuario que está vinculada a todos los objetos de caché de datos creados por el control de origen de datos. |
| ChildControlsCreated |
Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Heredado de Control) |
| ClientID |
Obtiene el identificador del control de servidor generado por ASP.NET. (Heredado de DataSourceControl) |
| ClientIDMode |
Esta propiedad no se utiliza para los controles de orígenes de datos. (Heredado de DataSourceControl) |
| ClientIDSeparator |
Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Heredado de Control) |
| ConflictDetection |
Obtiene o establece un valor que determina si solo se pasan los nuevos valores al método |
| Context |
Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Heredado de Control) |
| Controls |
Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario. (Heredado de DataSourceControl) |
| ConvertNullToDBNull |
Obtiene o establece un valor que indica si el control Parameter convierte automáticamente los valores de Value que se pasan a una operación de actualización, inserción o eliminación desde |
| DataItemContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Heredado de Control) |
| DataKeysContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Heredado de Control) |
| DataObjectTypeName |
Obtiene o establece el nombre de una clase que el control ObjectDataSource utiliza para un parámetro de una operación que actualiza, inserta o elimina datos, en lugar de pasar valores individuales desde el control enlazado a datos. |
| DeleteMethod |
Obtiene o establece el nombre del método o la función que invoca el control ObjectDataSource para eliminar los datos. |
| DeleteParameters |
Obtiene la colección de parámetros que contiene los parámetros utilizados por el método DeleteMethod. |
| DesignMode |
Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Heredado de Control) |
| EnableCaching |
Obtiene o establece un valor que indica si el control ObjectDataSource está habilitado. |
| EnablePaging |
Obtiene o establece un valor que indica si el control de origen de datos admite la paginación en el conjunto de datos recuperado. |
| EnableTheming |
Obtiene un valor que indica si el control admite temas. (Heredado de DataSourceControl) |
| EnableViewState |
Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control) |
| Events |
Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Heredado de Control) |
| FilterExpression |
Obtiene o establece una expresión de filtrado que se aplica cuando se llama al método que se especifica mediante la propiedad SelectMethod. |
| FilterParameters |
Obtiene una colección de parámetros asociados a los marcadores de posición de parámetro de la cadena FilterExpression. |
| HasChildViewState |
Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Heredado de Control) |
| ID |
Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control) |
| IdSeparator |
Obtiene el carácter utilizado para separar los identificadores de control. (Heredado de Control) |
| InsertMethod |
Obtiene o establece el nombre del método o la función que invoca el control ObjectDataSource para insertar los datos. |
| InsertParameters |
Obtiene la colección de parámetros que contiene los parámetros utilizados por la propiedad InsertMethod. |
| IsChildControlStateCleared |
Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Heredado de Control) |
| IsTrackingViewState |
Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Heredado de Control) |
| IsViewStateEnabled |
Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control) |
| LoadViewStateByID |
Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Heredado de Control) |
| MaximumRowsParameterName |
Obtiene o establece el nombre del parámetro del método de recuperación de datos del objeto comercial utilizado para indicar el número de registros que se recuperan para admitir la paginación de origen de datos. |
| NamingContainer |
Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID. (Heredado de Control) |
| OldValuesParameterFormatString |
Obtiene o establece una cadena de formato para aplicarla a los nombres de los parámetros de los valores originales que se pasan a los métodos |
| Page |
Obtiene una referencia a la instancia Page que contiene el control de servidor. (Heredado de Control) |
| Parent |
Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Heredado de Control) |
| ParsingCulture |
Obtiene o establece un valor que indica qué información de referencia cultural se utiliza al convertir valores de cadena a los tipos de propiedad reales para construir un objeto del tipo indicado por DataObjectTypeName. |
| RenderingCompatibility |
Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Heredado de Control) |
| SelectCountMethod |
Obtiene o establece el nombre del método o función a los que invoca el control ObjectDataSource para recuperar un recuento de filas. |
| SelectMethod |
Obtiene o establece el nombre del método o función a los que invoca el control ObjectDataSource para recuperar datos. |
| SelectParameters |
Obtiene una colección de los parámetros que usa el método especificado por la propiedad SelectMethod. |
| Site |
Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Heredado de Control) |
| SkinID |
Obtiene la máscara que se va a aplicar al control DataSourceControl. (Heredado de DataSourceControl) |
| SortParameterName |
Obtiene o establece el nombre del objeto comercial que utilizó el parámetro SelectMethod para especificar una expresión de ordenación para admitir la ordenación del origen de datos. |
| SqlCacheDependency |
Obtiene o establece una cadena delimitada por puntos y comas que indica las bases de datos y las tablas que deben utilizarse para la dependencia de caché de Microsoft SQL Server. |
| StartRowIndexParameterName |
Obtiene o establece el nombre del parámetro del método de recuperación de datos utilizado para indicar el valor del identificador del primer registro que se recupera para admitir la paginación del origen de datos. |
| TemplateControl |
Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control) |
| TemplateSourceDirectory |
Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control) |
| TypeName |
Obtiene o establece el nombre de la clase que representa el objeto ObjectDataSource. |
| UniqueID |
Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control) |
| UpdateMethod |
Obtiene o establece el nombre del método o la función que invoca el control ObjectDataSource para actualizar los datos. |
| UpdateParameters |
Obtiene la colección de parámetros que contiene los parámetros utilizados por el método especificado por la propiedad UpdateMethod. |
| ValidateRequestMode |
Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Heredado de Control) |
| ViewState |
Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Heredado de Control) |
| ViewStateIgnoresCase |
Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Heredado de Control) |
| ViewStateMode |
Obtiene o establece el modo del estado de vista de este control. (Heredado de Control) |
| Visible |
Obtiene o establece un valor que indica si el control se muestra gráficamente. (Heredado de DataSourceControl) |
Métodos
| AddedControl(Control, Int32) |
Se llama después de agregar un control secundario a la colección Controls del objeto Control. (Heredado de Control) |
| AddParsedSubObject(Object) |
Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor. (Heredado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica al control las propiedades de estilo definidas en la hoja de estilos de página. (Heredado de DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
| BuildProfileTree(String, Boolean) |
Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Heredado de Control) |
| ClearCachedClientID() |
Establece en |
| ClearChildControlState() |
Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildState() |
Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildViewState() |
Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control) |
| ClearEffectiveClientIDMode() |
Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Heredado de Control) |
| CreateChildControls() |
Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos. (Heredado de Control) |
| CreateControlCollection() |
Crea una colección para almacenar controles secundarios. (Heredado de DataSourceControl) |
| DataBind() |
Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Heredado de Control) |
| DataBind(Boolean) |
Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Heredado de Control) |
| DataBindChildren() |
Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control) |
| Delete() |
Realiza una operación de eliminación llamando al método que se identifica mediante la propiedad DeleteMethod con cualquier parámetro que esté en la colección DeleteParameters. |
| Dispose() |
Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Heredado de Control) |
| EndRenderTracing(TextWriter, Object) |
Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
| EnsureChildControls() |
Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Heredado de Control) |
| EnsureID() |
Crea un identificador para controles que no tiene un identificador asignado. (Heredado de Control) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| FindControl(String) |
Busca un control de servidor con el parámetro |
| FindControl(String, Int32) |
Busca el contenedor de nomenclatura actual para un control de servidor con el |
| Focus() |
Establece el foco de entrada en el control. (Heredado de DataSourceControl) |
| GetDesignModeState() |
Obtiene datos en tiempo de diseño para un control. (Heredado de Control) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetRouteUrl(Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
| GetRouteUrl(String, Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Heredado de Control) |
| GetView(String) |
Recupera la vista de origen de datos con nombre asociada al control de origen de datos. |
| GetViewNames() |
Recupera una colección de nombres que representa la lista de objetos de vista asociados al objeto ObjectDataSource. |
| HasControls() |
Determina si el control de servidor contiene controles secundarios. (Heredado de DataSourceControl) |
| HasEvents() |
Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Heredado de Control) |
| Insert() |
Realiza una operación de inserción mediante una llamada al método identificado por la propiedad InsertMethod y cualquier parámetro de la colección InsertParameters. |
| IsLiteralContent() |
Determina si el control de servidor alberga únicamente contenido literal. (Heredado de Control) |
| LoadControlState(Object) |
Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState(). (Heredado de Control) |
| LoadViewState(Object) |
Carga el estado de vista guardado previamente del control ObjectDataSource. |
| MapPathSecure(String) |
Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página. (Heredado de Control) |
| OnDataBinding(EventArgs) |
Genera el evento DataBinding. (Heredado de Control) |
| OnInit(EventArgs) |
Agrega un controlador de eventos LoadComplete a la página que contiene el control ObjectDataSource. |
| OnLoad(EventArgs) |
Genera el evento Load. (Heredado de Control) |
| OnPreRender(EventArgs) |
Genera el evento PreRender. (Heredado de Control) |
| OnUnload(EventArgs) |
Genera el evento Unload. (Heredado de Control) |
| OpenFile(String) |
Obtiene un objeto Stream utilizado para leer un archivo. (Heredado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Asigna los orígenes del evento y su información al control principal del control. (Heredado de Control) |
| RaiseDataSourceChangedEvent(EventArgs) |
Genera el evento DataSourceChanged. (Heredado de DataSourceControl) |
| RemovedControl(Control) |
Se llama después de quitar un control secundario de la colección Controls del objeto Control. (Heredado de Control) |
| Render(HtmlTextWriter) |
Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente. (Heredado de Control) |
| RenderChildren(HtmlTextWriter) |
Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control) |
| RenderControl(HtmlTextWriter) |
Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento. (Heredado de DataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Heredado de Control) |
| ResolveAdapter() |
Obtiene el adaptador de controles que se encarga de representar el control especificado. (Heredado de Control) |
| ResolveClientUrl(String) |
Obtiene una dirección URL que el explorador puede utilizar. (Heredado de Control) |
| ResolveUrl(String) |
Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Heredado de Control) |
| SaveControlState() |
Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor. (Heredado de Control) |
| SaveViewState() |
Guarda el estado del control ObjectDataSource. |
| Select() |
Recupera los datos del almacenamiento de datos subyacente mediante una llamada al método identificado por la propiedad SelectMethod con los parámetros de la colección SelectParameters. |
| SetDesignModeState(IDictionary) |
Establece los datos en tiempo de diseño para un control. (Heredado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Heredado de Control) |
| SetTraceData(Object, Object) |
Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento. (Heredado de Control) |
| SetTraceData(Object, Object, Object) |
Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento. (Heredado de Control) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| TrackViewState() |
Efectúa el seguimiento de los cambios en el estado de vista del control ObjectDataSource para poder almacenarlos en el objeto StateBag. |
| Update() |
Realiza una operación de actualización llamando al método que se identifica mediante la propiedad UpdateMethod y cualquier parámetro que esté en la colección UpdateParameters. |
Eventos
| DataBinding |
Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control) |
| Deleted |
Tiene lugar cuando se termina una operación de Delete(). |
| Deleting |
Tiene lugar antes de una operación de Delete(). |
| Disposed |
Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Heredado de Control) |
| Filtering |
Se produce antes de una operación de filtrado. |
| Init |
Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Heredado de Control) |
| Inserted |
Tiene lugar cuando se termina una operación de Insert(). |
| Inserting |
Tiene lugar antes de una operación de Insert(). |
| Load |
Se produce cuando el control de servidor se carga en el objeto Page. (Heredado de Control) |
| ObjectCreated |
Aparece después de crear el objeto identificado por la propiedad TypeName. |
| ObjectCreating |
Aparece antes de crear el objeto identificado por la propiedad TypeName. |
| ObjectDisposing |
Aparece antes de descartar el objeto identificado por la propiedad TypeName. |
| PreRender |
Se produce una vez que se carga el objeto Control, pero antes de su representación. (Heredado de Control) |
| Selected |
Tiene lugar cuando se termina una operación de Select(). |
| Selecting |
Tiene lugar antes de una operación de Select(). |
| Unload |
Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control) |
| Updated |
Tiene lugar cuando se termina una operación de Update(). |
| Updating |
Tiene lugar antes de una operación de Update(). |
Implementaciones de interfaz explícitas
| IControlBuilderAccessor.ControlBuilder |
Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control) |
| IControlDesignerAccessor.UserData |
Para obtener una descripción de este miembro, vea UserData. (Heredado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control) |
| IDataSource.DataSourceChanged |
Se produce cuando un control de origen de datos ha cambiado de modo que afecta a los controles enlazados a datos. (Heredado de DataSourceControl) |
| IDataSource.GetView(String) |
Obtiene el objeto DataSourceView con nombre asociado al control DataSourceControl. Ciertos controles de origen de datos sólo admiten una vista, mientras que otros admiten más de una. (Heredado de DataSourceControl) |
| IDataSource.GetViewNames() |
Obtiene una colección de nombres, que representa la lista de objetos DataSourceView asociados al control DataSourceControl. (Heredado de DataSourceControl) |
| IExpressionsAccessor.Expressions |
Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control) |
| IListSource.ContainsListCollection |
Indica si el control de origen de datos está asociado a una o varias listas de datos. (Heredado de DataSourceControl) |
| IListSource.GetList() |
Obtiene una lista de controles de origen de datos que pueden utilizarse como orígenes de listas de datos. (Heredado de DataSourceControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control) |
Métodos de extensión
| FindDataSourceControl(Control) |
Devuelve el origen de datos que está asociado al control de datos del control especificado. |
| FindFieldTemplate(Control, String) |
Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. |
| FindMetaTable(Control) |
Devuelve el objeto de metatabla para el control de datos contenedor. |
| GetDefaultValues(IDataSource) |
Obtiene la colección de los valores predeterminados para el origen de datos especificado. |
| GetMetaTable(IDataSource) |
Obtiene los metadatos para una tabla en el objeto de origen de datos especificado. |
| TryGetMetaTable(IDataSource, MetaTable) |
Determina si están disponibles los metadatos de la tabla. |
Se aplica a
Consulte también
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Tutorial: Enlace de datos a un objeto empresarial personalizado
- Controles de servidor web de orígenes de datos
- Información general sobre el control ObjectDataSource
- Crear un objeto de origen para un control ObjectDataSource
- Uso de Entity Framework y el control ObjectDataSource
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de