ObjectDataSource Clase

Definición

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 DataSourceControl
Public Class ObjectDataSource
Inherits DataSourceControl
Herencia
ObjectDataSource
Atributos

Ejemplos

En esta sección se muestra un ObjectDataSource elemento en el marcado de una página de .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 de 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 EmployeeLogic clase es la clase lógica de negocios que ObjectDataSource usa .

  • La NorthwindEmployee clase define el objeto de datos devuelto por el GetAllEmployees método de la EmployeeLogic clase .

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. Cree métodos que recuperen y actualicen los datos y proporcione los nombres de esos métodos al ObjectDataSource control en el marcado. Durante el procesamiento de representación o postback, ObjectDataSource llama a los métodos que ha especificado.

No hay 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 el nivel 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 de negocio 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. Es posible que el uso de un objeto costoso no sea 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 los datos. Si el método no devuelve un IEnumerable objeto o DataSet , el tiempo de ejecución de una IEnumerable colección encapsula 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 los 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 DataBind se llama al ObjectDataSource método especificado por la SelectMethod propiedad se llaman automáticamente. 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.

Realizar 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 desee 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 coinciden 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é le 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 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 devuelva un objeto que implemente 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 escribiría como 15/10/2009 y se rechazaría como una 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 clase es la interfaz con la ObjectDataSourceView 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 tiene solo uno asociado ObjectDataSourceViewy siempre se denomina DefaultView. Mientras el método expone el ObjectDataSourceViewGetView 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 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 Update o si se pasan tanto los antiguos como los nuevos al método Update.

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 null al valor ObjectDataSource.

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 Delete o Update.

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 null el valor de ClientID almacenado en caché.

(Heredado de Control)
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 id especificado en el contenedor de nomenclatura actual.

(Heredado de DataSourceControl)
FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar.

(Heredado de Control)
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