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.Represents a business object that provides data to data-bound controls in multitier Web application architectures.

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

Ejemplos

Un proyecto de sitio web de Visual Studio con código fuente está disponible para acompañar este tema: Descargar.A Visual Studio Web site project with source code is available to accompany this topic: Download.

En esta sección se muestra una ObjectDataSource en el marcado en una página. aspx y se muestran los objetos empresariales con los que trabaja.This section shows an ObjectDataSource in markup in an .aspx page and it shows the business objects that it works with. El ejemplo es la página. aspx.The example is the .aspx page. Contiene un control GridView que está enlazado a un control ObjectDataSource.It contains a GridView control that is bound to an ObjectDataSource control. El marcado del control ObjectDataSource especifica el nombre del objeto comercial y el nombre del método de objeto comercial al que se va a llamar para recuperar datos.The ObjectDataSource control markup specifies the name of the business object and the name of the business object method to call in order to retrieve data.

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

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

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

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

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

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

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

En el ejemplo siguiente se muestra el objeto comercial que usa el control ObjectDataSource en la página. aspx.The following example shows the business object that the ObjectDataSource control in the .aspx page uses. (Muchos otros ejemplos de código de ObjectDataSource usan este objeto comercial también). El ejemplo consta de las dos clases básicas siguientes:(Many other ObjectDataSource code examples use this business object also.) The example consists of the following two basic classes:

  • La clase EmployeeLogic es la clase de lógica de negocios que usa el ObjectDataSource.The EmployeeLogic class is the business logic class that the ObjectDataSource uses.

  • La clase NorthwindEmployee define el objeto de datos devuelto por el método GetAllEmployees de la clase EmployeeLogic.The NorthwindEmployee class defines the data object that is returned by the GetAllEmployees method of the EmployeeLogic class.

Se proporciona una clase de NorthwindDataException adicional como comodidad.An additional NorthwindDataException class is provided as a convenience.

Este conjunto de clases de ejemplo funciona con la base de datos Northwind Traders, que está disponible con Microsoft SQL Server y Microsoft Access.This set of example classes works with the Northwind Traders database, which is available with Microsoft SQL Server and 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.For a complete working example, you must compile and use these classes with the .aspx page example that is provided.

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:In this topic:

IntroducciónIntroduction

Un control de ObjectDataSource funciona con una clase que se crea.An ObjectDataSource control works with a class that you create. Cree métodos que recuperen y actualicen los datos, y proporcione los nombres de esos métodos al control ObjectDataSource en el marcado.You create methods that retrieve and update data, and you provide the names of those methods to the ObjectDataSource control in markup. Durante la representación o el procesamiento de postback, el ObjectDataSource llama a los métodos que ha especificado.During rendering or postback processing, the ObjectDataSource calls the methods that you have specified.

No hay ninguna representación visual del control ObjectDataSource.There is no visual rendering of the ObjectDataSource control. Como resultado, el ObjectDataSource no admite características visuales como la propiedad EnableTheming o SkinID.As a result, the ObjectDataSource does not support visual features such as the EnableTheming or SkinID property.

PropósitoPurpose

Una práctica de diseño de aplicaciones muy común es separar el nivel de presentación de la lógica de negocios y encapsular la lógica de negocios en objetos empresariales.A very common application design practice is to separate the presentation layer from business logic and to encapsulate the business logic in business objects. Estos objetos comerciales forman una capa distinta entre el nivel de presentación y el nivel de datos, lo que da lugar a una arquitectura de aplicación de tres niveles.These business objects form a distinct layer between the presentation layer and the data tier, resulting in a three-tier application architecture. El control ObjectDataSource permite a los desarrolladores utilizar un control de origen de datos ASP.NET a la vez que conservan su arquitectura de aplicación de tres niveles.The ObjectDataSource control enables developers to use an ASP.NET data source control while retaining their three-tier application architecture.

El control ObjectDataSource usa la reflexión para crear instancias de objetos comerciales y llamar a métodos en ellos para recuperar, actualizar, insertar y eliminar datos.The ObjectDataSource control uses reflection to create instances of business objects and to call methods on them to retrieve, update, insert, and delete data. La propiedad TypeName identifica el nombre de la clase con la que funciona el ObjectDataSource.The TypeName property identifies the name of the class that the ObjectDataSource works with. El control ObjectDataSource crea y destruye una instancia de la clase para cada llamada al método. no contiene el objeto en memoria durante la vigencia de la solicitud Web.The ObjectDataSource control creates and destroys an instance of the class for each method call; it does not hold the object in memory for the lifetime of the Web request. Esta es una consideración importante si el objeto comercial que se utiliza requiere muchos recursos o si es caro crear y destruir.This is a serious consideration if the business object that you use requires many resources or is otherwise expensive to create and destroy. El uso de un objeto caro podría no ser una opción de diseño óptima, pero puede controlar el ciclo de vida del objeto mediante los eventos ObjectCreating, ObjectCreatedy ObjectDisposing.Using an expensive object might not be an optimal design choice, but you can control the life cycle of the object by using the ObjectCreating, ObjectCreated, and ObjectDisposing events.

Nota

Los métodos identificados por las propiedades SelectMethod, UpdateMethod, InsertMethody DeleteMethod pueden ser métodos de instancia o métodos static (Shared en Visual Basic).The methods that are identified by the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod properties can be instance methods or static (Shared in Visual Basic) methods. Si los métodos son static (Shared en Visual Basic), no se crea una instancia del objeto comercial y no se generan los eventos ObjectCreating, ObjectCreatedy ObjectDisposing.If the methods are static (Shared in Visual Basic), an instance of the business object is not created, and the ObjectCreating, ObjectCreated, and ObjectDisposing events are not raised.

Recuperación de datosRetrieving Data

Para recuperar datos de un objeto comercial, establezca la propiedad SelectMethod en el nombre del método que recupera los datos.To retrieve data from a business object, set the SelectMethod property to the name of the method that retrieves data. Si el método no devuelve un objeto IEnumerable o DataSet, el motor en tiempo de ejecución ajusta el objeto en una colección IEnumerable.If the method does not return an IEnumerable or DataSet object, the object is wrapped by the runtime in an IEnumerable collection. Si la firma del método tiene parámetros, puede agregar objetos Parameter a la colección SelectParameters y, a continuación, enlazarlos a los valores que desea pasar al método especificado por la propiedad SelectMethod.If the method signature has parameters, you can add Parameter objects to the SelectParameters collection, and then bind them to the values that you want to pass to the method that is specified by the SelectMethod property. Para que el control de ObjectDataSource use los parámetros, los parámetros deben coincidir con los nombres y tipos de los parámetros de la Signatura del método.In order for the ObjectDataSource control to use the parameters, the parameters must match the names and types of the parameters in the method signature. Para obtener más información, vea usar parámetros con el control ObjectDataSource.For more information, see Using Parameters with the ObjectDataSource Control.

El control ObjectDataSource recupera los datos cada vez que se llama al método Select.The ObjectDataSource control retrieves data whenever the Select method is called. Este método proporciona acceso mediante programación al método especificado por SelectMethod propiedad.This method provides programmatic access to the method that is specified by SelectMethod property. Los controles que se enlazan a la ObjectDataSource llaman automáticamente al método que especifica la propiedad SelectMethod cuando se llama a su método DataBind.The method that is specified by the SelectMethod property is called automatically by controls that are bound to the ObjectDataSource when their DataBind method is called. Si establece la propiedad DataSourceID de un control enlazado a datos, el control se enlaza automáticamente a los datos del origen de datos, según sea necesario.If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as needed. Establecer la propiedad DataSourceID es el método recomendado para enlazar un control ObjectDataSource a un control enlazado a datos.Setting the DataSourceID property is the recommended method for binding an ObjectDataSource control to a data-bound control. Como alternativa, puede establecer la propiedad DataSource, pero debe llamar explícitamente al método DataBind del control enlazado a datos.Alternatively, you can set the DataSource property, but then you must explicitly call the DataBind method of the data-bound control. Puede llamar al método Select mediante programación en cualquier momento para recuperar los datos.You can call the Select method programmatically at any time to retrieve data.

Para obtener más información sobre cómo enlazar controles enlazados a datos a controles de origen de datos, vea enlazar a datos mediante un control de origen de datos.For more information about binding data-bound controls to data source controls, see Binding to Data Using a Data Source Control.

Realización de operaciones de datosPerforming Data Operations

En función de las capacidades del objeto comercial con el que funciona el control de ObjectDataSource, puede realizar operaciones de datos, como actualizaciones, inserciones y eliminaciones.Depending on the capabilities of the business object that the ObjectDataSource control works with, you can perform data operations, such as updates, insertions, and deletions. Para realizar estas operaciones de datos, establezca el nombre de método adecuado y los parámetros asociados para la operación que desea realizar.To perform these data operations, set the appropriate method name and any associated parameters for the operation that you want to perform. Por ejemplo, para una operación de actualización, establezca la propiedad UpdateMethod en el nombre del método de objeto comercial que realiza las actualizaciones y agregue los parámetros necesarios a la colección de UpdateParameters.For example, for an update operation, set the UpdateMethod property to the name of the business object method that performs updates and add any required parameters to the UpdateParameters collection. Si el control de ObjectDataSource está asociado a un control enlazado a datos, el control enlazado a datos agrega los parámetros.If the ObjectDataSource control is associated with a data-bound control, the parameters are added by the data-bound control. 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.In this case, you need to ensure that the parameter names of the method match the field names in the data-bound control. La actualización se realiza cuando se llama al método Update, ya sea explícitamente mediante el código o automáticamente por un control enlazado a datos.The update is performed when the Update method is called, either explicitly by your code or automatically by a data-bound control. Se sigue el mismo patrón general para las operaciones Delete y Insert.The same general pattern is followed for Delete and Insert operations. Se supone que los objetos de negocio realizan estos tipos de operaciones de datos en un registro a la vez, en lugar de procesarse por lotes.Business objects are assumed to perform these types of data operations one record at a time, rather than batched.

Filtrado de datosFiltering Data

El control ObjectDataSource puede filtrar los datos recuperados por la propiedad SelectMethod, si los datos se devuelven como un objeto DataSet o DataTable.The ObjectDataSource control can filter data that is retrieved by the SelectMethod property, if the data is returned as a DataSet or DataTable object. Puede establecer la propiedad FilterExpression en una expresión de filtrado usando una sintaxis de cadena de formato y enlazar los valores de la expresión a los parámetros que se especifican en la colección FilterParameters.You can set the FilterExpression property to a filtering expression by using a format string syntax and bind values in the expression to parameters that are specified in the FilterParameters collection.

Almacenamiento en memoria cachéCaching

Aunque el ObjectDataSource no conserva la instancia del objeto comercial en varias solicitudes, puede almacenar en caché el resultado de llamar al método identificado por la propiedad SelectMethod.Although the ObjectDataSource does not retain the instance of the business object across multiple requests, it can cache the result of calling the method identified by the SelectMethod property. Mientras los datos están almacenados en memoria caché, las llamadas subsiguientes al método Select devuelven los datos almacenados en caché en lugar de crear el objeto comercial y llamar a su SelectMethod mediante la reflexión.While the data is cached, subsequent calls to the Select method return the cached data instead of creating the business object and calling its SelectMethod using reflection. 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.Caching lets you avoid creating the object and calling its data method at the expense of memory on the Web server. El ObjectDataSource almacena automáticamente en caché los datos cuando la propiedad EnableCaching está establecida en truey la propiedad CacheDuration está establecida en el número de segundos que la memoria caché almacena los datos antes de que se descarte la memoria caché.The ObjectDataSource automatically caches data when the EnableCaching property is set to true, and the CacheDuration property is set to the number of seconds that the cache stores data before the cache is discarded. También puede especificar una propiedad de CacheExpirationPolicy y una propiedad SqlCacheDependency opcional.You can also specify a CacheExpirationPolicy property and an optional SqlCacheDependency property. El control ObjectDataSource permite almacenar en caché todos los tipos de datos, pero no debe almacenar en caché los objetos que retienen los recursos o el estado que no se pueden compartir para atender varias solicitudes (por ejemplo, un objeto de SqlDataReader abierto), porque la misma instancia del objeto se usará para atender varias solicitudes.The ObjectDataSource control allows you to cache all types of data, but you should not cache objects that retain resources or state that cannot be shared to service multiple requests (for example, an open SqlDataReader object), because the same instance of the object will be used to service multiple requests.

CaracterísticasFeatures

En la tabla siguiente se describen las características del control ObjectDataSource.The following table describes the features of the ObjectDataSource control.

CapacidadCapability RequisitosRequirements
SeleccionarSelecting Establezca la propiedad SelectMethod en el nombre del método de objeto comercial que selecciona los datos e incluya los parámetros necesarios en la colección SelectParameters mediante programación o mediante un control enlazado a datos.Set the SelectMethod property to the name of the business object method that selects data, and include any necessary parameters in the SelectParameters collection either programmatically or by using a data-bound control.
OrdenaciónSorting Establezca la propiedad SortParameterName en el nombre del parámetro en el método SelectMethod que incluye los criterios de ordenación.Set the SortParameterName property to the name of the parameter in the SelectMethod method that carries the sort criteria.
FiltrosFiltering Establezca la propiedad FilterExpression en una expresión de filtrado y, opcionalmente, agregue parámetros a la colección FilterParameters para filtrar los datos cuando se llame al método Select.Set the FilterExpression property to a filtering expression and optionally add any parameters to the FilterParameters collection to filter the data when the Select method is called. El método especificado por la propiedad SelectMethod debe devolver un DataSet o DataTable.The method specified by the SelectMethod property must return a DataSet or DataTable.
PaginaciónPaging Se admite la paginación del origen de datos, si el método SelectMethod 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.Data source paging is supported, if the SelectMethod method contains parameters for the maximum number of records to retrieve and the index of the first record to retrieve. Los nombres de esos parámetros deben establecerse en las propiedades MaximumRowsParameterName y StartRowIndexParameterName, respectivamente.The names of those parameters must be set in the MaximumRowsParameterName and StartRowIndexParameterName properties, respectively. Un control enlazado a datos podría realizar la paginación propiamente dicha, incluso si el control de ObjectDataSource no admite la paginación directamente en el método especificado por la propiedad SelectMethod.A data-bound control might be able to perform paging itself, even if the ObjectDataSource control does not support paging directly in the method specified by the SelectMethod property. El requisito de que el control enlazado a datos pueda hacerlo es que el método especificado por la propiedad SelectMethod devuelve un objeto que implementa la interfaz ICollection.The requirement for the data-bound control to be able to do this is that the method specified by the SelectMethod property return an object that implements the ICollection interface.
ActualizandoUpdating Establezca la propiedad UpdateMethod en el nombre del método de objeto comercial que actualiza los datos e incluya los parámetros necesarios en la colección UpdateParameters.Set the UpdateMethod property to the name of the business object method that updates data, and include any necessary parameters in the UpdateParameters collection.
EliminandoDeleting Establezca la propiedad DeleteMethod en el nombre del método de objeto comercial o función que elimina los datos e incluya los parámetros necesarios en la colección DeleteParameters.Set the DeleteMethod property to the name of the business object method or function that deletes data, and include any necessary parameters in the DeleteParameters collection.
InserciónInserting Establezca la propiedad InsertMethod en el nombre del método de objeto comercial o función que inserta los datos e incluya los parámetros necesarios en la colección InsertParameters.Set the InsertMethod property to the name of the business object method or function that inserts data, and include any necessary parameters in the InsertParameters collection.
Almacenamiento en memoria cachéCaching Establezca la propiedad EnableCaching en truey las propiedades CacheDuration y CacheExpirationPolicy según el comportamiento de almacenamiento en caché que desee para los datos almacenados en caché.Set the EnableCaching property to true, and the CacheDuration and CacheExpirationPolicy properties according to the caching behavior you want for your cached data.

Nota

Cuando se usa la clase ObjectDataSource 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.When you use the ObjectDataSource class to update or insert data, strings that are entered at the client are not automatically converted from the client culture format to the server culture format. Por ejemplo, la referencia cultural del cliente podría especificar DD/MM/YYYY como formato de fecha y el formato de fecha en el servidor podría ser MM/DD/AAAA.For example, the client culture might specify DD/MM/YYYY as the date format, and the date format on the server might be MM/DD/YYYY. En ese caso, el 5 de octubre de 2009 se escribiría en un control de TextBox como 5/10/2009, pero se interpretaría como el 10 de mayo de 2009.In that case, October 5, 2009 would be entered in a TextBox control as 5/10/2009 but would be interpreted as May 10, 2009. El 15 de octubre de 2009 se escribiría como 15/10/2009 y se rechazaría como una fecha no válida.October 15, 2009 would be entered as 15/10/2009, and would be rejected as an invalid date.

Vista de datosData View

Al igual que con todos los controles de origen de datos, el control ObjectDataSource está asociado a una clase de vista del origen de datos.As with all data source controls, the ObjectDataSource control is associated with a data source view class. Aunque el control ObjectDataSource es la interfaz que el desarrollador de páginas usa para trabajar con datos, la clase ObjectDataSourceView es la interfaz con la que funcionan los controles enlazados a datos.While the ObjectDataSource control is the interface that the page developer uses to work with data, the ObjectDataSourceView class is the interface that data-bound controls work with. Además, la clase ObjectDataSourceView describe las capacidades del control de origen de datos y realiza el trabajo real.Additionally, the ObjectDataSourceView class describes the capabilities of the data source control, and performs the actual work. El control ObjectDataSource tiene solo un ObjectDataSourceViewasociado y siempre se denomina DefaultView.The ObjectDataSource control has only one associated ObjectDataSourceView, and it is always named DefaultView. Aunque el método GetView expone el objeto ObjectDataSourceView, muchas de sus propiedades y métodos se ajustan y exponen directamente el control ObjectDataSource.While the ObjectDataSourceView object is exposed by the GetView method, many of its properties and methods are wrapped and exposed directly by the ObjectDataSource control. En segundo plano, el objeto ObjectDataSourceView realiza todas las operaciones de datos, incluida la recuperación, inserción, actualización, eliminación, filtrado y ordenación de los datos.Behind the scenes, the ObjectDataSourceView object performs all data operations, including retrieving, inserting, updating, deleting, filtering, and sorting the data. Para más información, consulte ObjectDataSourceView.For more information, see ObjectDataSourceView.

Usar LINQ to SQLUsing LINQ to SQL

Puede usar el control ObjectDataSource con una clase LINQ to SQL.You can use the ObjectDataSource control with a LINQ to SQL class. Para ello, establezca la propiedad TypeName en el nombre de la clase de contexto de datos.To do so, you set the TypeName property to the name of the data-context class. También se establecen los métodos SelectMethod, UpdateMethod, InsertMethody DeleteMethod en los métodos de la clase de contexto de datos que realizan las operaciones correspondientes.You also set the SelectMethod, UpdateMethod, InsertMethod, and DeleteMethod methods to the methods in the data-context class that perform the corresponding operations. Debe crear un controlador de eventos para el evento ObjectDisposing para cancelar la eliminación de la clase de contexto de datos.You must create an event handler for the ObjectDisposing event in order to cancel disposing of the data-context class. Este paso es necesario porque LINQ to SQL admite la ejecución diferida, mientras que el control ObjectDataSource intenta eliminar el contexto de datos después de la operación Select.This step is necessary because LINQ to SQL supports deferred execution, whereas the ObjectDataSource control tries to dispose the data context after the Select operation. Para obtener más información sobre cómo crear clases de LINQ to SQL, vea Cómo: crear clases de LINQ to SQL en un proyecto web.For more information about how to create LINQ to SQL classes, see 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 evento ObjectDisposing.For an example of how to cancel the disposing of a data context class, see the ObjectDisposing event.

Usar el Entity FrameworkUsing the Entity Framework

También puede utilizar el control ObjectDataSource con el Entity Framework.You can also use the ObjectDataSource control with the Entity Framework. Para obtener más información, vea usar el Entity Framework y el control ObjectDataSource.For more information, see Using the Entity Framework and the ObjectDataSource Control.

Sintaxis declarativaDeclarative Syntax

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

Constructores

ObjectDataSource()

Inicializa una nueva instancia de la clase ObjectDataSource.Initializes a new instance of the ObjectDataSource class.

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

Propiedades

Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the 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.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Heredado de Control)
BindingContainer

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

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

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

CacheKeyDependency

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

ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Heredado de Control)
ClientID

Obtiene el identificador del control de servidor generado por ASP.NET.Gets the server control identifier generated by ASP.NET.

(Heredado de DataSourceControl)
ClientIDMode

Esta propiedad no se utiliza para los controles de orígenes de datos.This property is not used for data source controls.

(Heredado de DataSourceControl)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

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

Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

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

(Heredado de DataSourceControl)
ConvertNullToDBNull

Obtiene o establece un valor que indica si el control Parameter convierte automáticamente los valores de null que se pasan a una operación de actualización, inserción o eliminación desde Value al valor ObjectDataSource.Gets or sets a value indicating whether the Parameter values that are passed to an update, insert, or delete operation are automatically converted from null to the Value value by the ObjectDataSource control.

DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements 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.Gets or sets the name of a class that the ObjectDataSource control uses for a parameter in an update, insert, or delete data operation, instead of passing individual values from the data-bound control.

DeleteMethod

Obtiene o establece el nombre del método o la función que invoca el control ObjectDataSource para eliminar los datos.Gets or sets the name of the method or function that the ObjectDataSource control invokes to delete data.

DeleteParameters

Obtiene la colección de parámetros que contiene los parámetros utilizados por el método DeleteMethod.Gets the parameters collection that contains the parameters that are used by the DeleteMethod method.

DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Heredado de Control)
EnableCaching

Obtiene o establece un valor que indica si el control ObjectDataSource está habilitado.Gets or sets a value indicating whether the ObjectDataSource control has data caching enabled.

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

EnableTheming

Obtiene un valor que indica si el control admite temas.Gets a value indicating whether this control supports themes.

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

(Heredado de Control)
Events

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de sólo lectura.This property is read-only.

(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.Gets or sets a filtering expression that is applied when the method that is specified by the SelectMethod property is called.

FilterParameters

Obtiene una colección de parámetros asociados a los marcadores de posición de parámetro de la cadena FilterExpression.Gets a collection of parameters that are associated with any parameter placeholders in the FilterExpression string.

HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Heredado de Control)
ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Heredado de Control)
IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

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

InsertParameters

Obtiene la colección de parámetros que contiene los parámetros utilizados por la propiedad InsertMethod.Gets the parameters collection that contains the parameters that are used by the InsertMethod property.

IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Heredado de Control)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Heredado de Control)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this 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.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

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

NamingContainer

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

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

Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Heredado de Control)
Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

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

RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

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

SelectMethod

Obtiene o establece el nombre del método o función a los que invoca el control ObjectDataSource para recuperar datos.Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve data.

SelectParameters

Obtiene una colección de los parámetros que usa el método especificado por la propiedad SelectMethod.Gets a collection of parameters that are used by the method specified by the SelectMethod property.

Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Heredado de Control)
SkinID

Obtiene la máscara que se va a aplicar al control DataSourceControl.Gets the skin to apply to the DataSourceControl control.

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

SqlCacheDependency

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

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

TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Heredado de Control)
TypeName

Obtiene o establece el nombre de la clase que representa el objeto ObjectDataSource.Gets or sets the name of the class that the ObjectDataSource object represents.

UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

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

UpdateParameters

Obtiene la colección de parámetros que contiene los parámetros utilizados por el método especificado por la propiedad UpdateMethod.Gets the parameters collection that contains the parameters that are used by the method that is specified by the UpdateMethod property.

ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

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

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Heredado de Control)
Visible

Obtiene o establece un valor que indica si el control se muestra gráficamente.Gets or sets a value indicating whether the control is visually displayed.

(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.Called after a child control is added to the Controls collection of the Control object.

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

(Heredado de Control)
ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de página.Applies the style properties that are defined in the page style sheet to the control.

(Heredado de DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

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

(Heredado de Control)
ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.Sets the cached ClientID value to null.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

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

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to 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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Heredado de Control)
CreateControlCollection()

Crea una colección para almacenar controles secundarios.Creates a collection to store child controls.

(Heredado de DataSourceControl)
DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.Binds a data source to the invoked server control and all its child controls.

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

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

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

Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.Enables a server control to perform final clean up before it is released from memory.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Heredado de Control)
EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

(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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

(Heredado de Control)
Focus()

Establece el foco de entrada en el control.Sets input focus to the control.

(Heredado de DataSourceControl)
GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

(Heredado de Control)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

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

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

(Heredado de Control)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Heredado de Control)
GetView(String)

Recupera la vista de origen de datos con nombre asociada al control de origen de datos.Retrieves the named data source view that is associated with the data source control.

GetViewNames()

Recupera una colección de nombres que representa la lista de objetos de vista asociados al objeto ObjectDataSource.Retrieves a collection of names representing the list of view objects that are associated with the ObjectDataSource object.

HasControls()

Determina si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Heredado de DataSourceControl)
HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

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

IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

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

(Heredado de Control)
LoadViewState(Object)

Carga el estado de vista guardado previamente del control ObjectDataSource.Loads the previously saved view state of the ObjectDataSource control.

MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Heredado de Control)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

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

(Heredado de Control)
OnDataBinding(EventArgs)

Genera el evento DataBinding.Raises the DataBinding event.

(Heredado de Control)
OnInit(EventArgs)

Agrega un controlador de eventos LoadComplete a la página que contiene el control ObjectDataSource.Adds a LoadComplete event handler to the page that contains the ObjectDataSource control.

OnLoad(EventArgs)

Genera el evento Load.Raises the Load event.

(Heredado de Control)
OnPreRender(EventArgs)

Genera el evento PreRender.Raises the PreRender event.

(Heredado de Control)
OnUnload(EventArgs)

Genera el evento Unload.Raises the Unload event.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.Assigns any sources of the event and its information to the control's parent.

(Heredado de Control)
RaiseDataSourceChangedEvent(EventArgs)

Genera el evento DataSourceChanged.Raises the DataSourceChanged event.

(Heredado de DataSourceControl)
RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(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.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Heredado de Control)
RenderChildren(HtmlTextWriter)

Envía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

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

(Heredado de DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Heredado de Control)
ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

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

(Heredado de Control)
SaveViewState()

Guarda el estado del control ObjectDataSource.Saves the state of the ObjectDataSource control.

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.Retrieves data from the underlying data storage by calling the method that is identified by the SelectMethod property with the parameters in the SelectParameters collection.

SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a 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.Assigns an event handler delegate to render the server control and its content into its parent control.

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

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

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

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

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

Eventos

DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Heredado de Control)
Deleted

Tiene lugar cuando se termina una operación de Delete().Occurs when a Delete() operation has completed.

Deleting

Tiene lugar antes de una operación de Delete().Occurs before a Delete() operation.

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

(Heredado de Control)
Filtering

Se produce antes de una operación de filtrado.Occurs before a filter operation.

Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Heredado de Control)
Inserted

Tiene lugar cuando se termina una operación de Insert().Occurs when an Insert() operation has completed.

Inserting

Tiene lugar antes de una operación de Insert().Occurs before an Insert() operation.

Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Heredado de Control)
ObjectCreated

Aparece después de crear el objeto identificado por la propiedad TypeName.Occurs after the object that is identified by the TypeName property is created.

ObjectCreating

Aparece antes de crear el objeto identificado por la propiedad TypeName.Occurs before the object that is identified by the TypeName property is created.

ObjectDisposing

Aparece antes de descartar el objeto identificado por la propiedad TypeName.Occurs before the object that is identified by the TypeName property is discarded.

PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Heredado de Control)
Selected

Tiene lugar cuando se termina una operación de Select().Occurs when a Select() operation has completed.

Selecting

Tiene lugar antes de una operación de Select().Occurs before a Select() operation.

Unload

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Heredado de Control)
Updated

Tiene lugar cuando se termina una operación de Update().Occurs when an Update() operation has completed.

Updating

Tiene lugar antes de una operación de Update().Occurs before an Update() operation.

Implementaciones de interfaz explícitas

IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obtener una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para obtener una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.For a description of this member, see 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.Occurs when a data source control has changed in a way that affects data-bound controls.

(Heredado de DataSourceControl)
IDataSource.GetView(String)

Obtiene el objeto DataSourceView con nombre asociado al control DataSourceControl.Gets the named DataSourceView object associated with the DataSourceControl control. Ciertos controles de origen de datos sólo admiten una vista, mientras que otros admiten más de una.Some data source controls support only one view, while others support more than one.

(Heredado de DataSourceControl)
IDataSource.GetViewNames()

Obtiene una colección de nombres, que representa la lista de objetos DataSourceView asociados al control DataSourceControl.Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control.

(Heredado de DataSourceControl)
IExpressionsAccessor.Expressions

Para obtener una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Heredado de Control)
IListSource.ContainsListCollection

Indica si el control de origen de datos está asociado a una o varias listas de datos.Indicates whether the data source control is associated with one or more lists of data.

(Heredado de DataSourceControl)
IListSource.GetList()

Obtiene una lista de controles de origen de datos que pueden utilizarse como orígenes de listas de datos.Gets a list of data source controls that can be used as sources of lists of data.

(Heredado de DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see 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.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

GetDefaultValues(IDataSource)

Obtiene la colección de los valores predeterminados para el origen de datos especificado.Gets the collection of the default values for the specified data source.

GetMetaTable(IDataSource)

Obtiene los metadatos para una tabla en el objeto de origen de datos especificado.Gets the metadata for a table in the specified data source object.

TryGetMetaTable(IDataSource, MetaTable)

Determina si están disponibles los metadatos de la tabla.Determines whether table metadata is available.

Se aplica a

Consulte también: