ObjectDataSource ObjectDataSource ObjectDataSource ObjectDataSource Class

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
Atributos

Ejemplos

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

Esta sección se muestra un ObjectDataSource en el marcado .aspx en la página y muestra los objetos de negocio 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 GridView control que está enlazado a un ObjectDataSource control.It contains a GridView control that is bound to an ObjectDataSource control. El ObjectDataSource marcado del control especifica el nombre del objeto comercial y el nombre del método del objeto de negocios va a llamar para recuperar los 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>

El ejemplo siguiente muestra el objeto de negocios que la ObjectDataSource usa el control de la página aspx.The following example shows the business object that the ObjectDataSource control in the .aspx page uses. (Muchas otras ObjectDataSource ejemplos de código usan este objeto de negocios 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:

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

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

Más NorthwindDataException clase se proporciona por comodidad.An additional NorthwindDataException class is provided as a convenience.

Este conjunto de clases de ejemplo funciona con la base de datos de 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 completo, debe compilar y utilizar 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. Para obtener información sobre cómo instalar la base de datos de Northwind Traders, vea Cómo: Instalar bases de datos de ejemplo.For information about how to install the Northwind Traders database, see How to: Install Sample Databases.

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
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 'UpdateEmployeeInfo

   Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
   End Sub 'DeleteEmployee

End Class 'EmployeeLogic


Public Class NorthwindEmployee


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


   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 'New

   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 'NorthwindEmployee


Friend Class NorthwindDataException
   Inherits Exception

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

Comentarios

En este tema:In this topic:

IntroducciónIntroduction

Un ObjectDataSource funciona con una clase que crea el control.An ObjectDataSource control works with a class that you create. Crear métodos que recuperen y actualicen los datos y proporcionar los nombres de los métodos a los ObjectDataSource control 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 procesamiento de la devolución, 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 de la ObjectDataSource control.There is no visual rendering of the ObjectDataSource control. Como resultado, el ObjectDataSource no admite características visuales, como el EnableTheming o SkinID propiedad.As a result, the ObjectDataSource does not support visual features such as the EnableTheming or SkinID property.

PropósitoPurpose

Una práctica muy común de diseño de aplicaciones es separar la capa de presentación de la lógica de negocios y encapsular la lógica de negocios en objetos de negocios.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 entre la capa de presentación y la capa de datos, lo que resulta en una arquitectura de aplicación de tres niveles distinta.These business objects form a distinct layer between the presentation layer and the data tier, resulting in a three-tier application architecture. El ObjectDataSource control permite a los desarrolladores usar un control de origen de datos ASP.NET mientras conserva 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 ObjectDataSource control usa la reflexión para crear instancias de objetos de negocios 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. El TypeName propiedad identifica el nombre de la clase que la ObjectDataSource funciona con.The TypeName property identifies the name of the class that the ObjectDataSource works with. El ObjectDataSource control crea y destruye una instancia de la clase para cada llamada al método; no contenga el objeto en la 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. Esto es una consideración importante si el objeto de negocios que utiliza requiere muchos recursos o en caso contrario, es costoso de 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. Uso de un objeto costoso podría no ser una mejor opción de diseño, pero puede controlar el ciclo de vida del objeto mediante el ObjectCreating, ObjectCreated, y ObjectDisposing eventos.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 que se identifican mediante el SelectMethod, UpdateMethod, InsertMethod, y DeleteMethod las propiedades pueden ser métodos de instancia o static (Shared en Visual Basic) métodos.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 el ObjectCreating, ObjectCreated, y ObjectDisposing no se generan eventos.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.

Recuperar datosRetrieving Data

Para recuperar datos de un objeto comercial, establezca el SelectMethod propiedad 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 IEnumerable o DataSet objeto, el objeto ajustado por el tiempo de ejecución en un IEnumerable colección.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 Parameter objetos a la SelectParameters colección y, a continuación, enlazan a los valores que se van a pasar al método especificado por el SelectMethod propiedad.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. En orden para el ObjectDataSource control para usar los parámetros, los parámetros deben coincidir con los nombres y tipos de los parámetros de la firma 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, consulte usar parámetros con el ObjectDataSource Control.For more information, see Using Parameters with the ObjectDataSource Control.

El ObjectDataSource control recupera los datos cada vez que el Select se llama al método.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. El método especificado por el SelectMethod propiedad se llama automáticamente a los controles que están enlazados a la ObjectDataSource cuando sus DataBind se llama al método.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 DataSourceID propiedad de un control enlazado a datos, el control se enlaza automáticamente a los datos del origen de datos, según sea necesario.If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as needed. Establecer el DataSourceID propiedad es el método recomendado para el enlace de un ObjectDataSource control 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 el DataSource propiedad, pero, a continuación, debe llamar explícitamente la DataBind método 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 a la Select método 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 acerca de los controles enlazados a datos de enlace 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

Según las capacidades de negocio de los objetos que la ObjectDataSource funciona con el control, 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 cualquier parámetro asociado 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 UpdateMethod propiedad en el nombre del método del objeto de negocios que realiza las actualizaciones y agrega cualquier requiere parámetros para el UpdateParameters colección.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 ObjectDataSource control está asociado a un control enlazado a datos, los parámetros se agregan mediante el control enlazado a datos.If the ObjectDataSource control is associated with a data-bound control, the parameters are added by the data-bound control. En este caso, deberá asegurarse de que los nombres de parámetro del método coincide con los nombres de campo en el 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 el Update se llama el método, ya sea explícitamente mediante 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 Delete y Insert operaciones.The same general pattern is followed for Delete and Insert operations. Objetos de negocios se asume que obtiene estos tipos de registro de una de las operaciones de datos a la vez, en lugar de procesar por lotes.Business objects are assumed to perform these types of data operations one record at a time, rather than batched.

Filtrar datosFiltering Data

El ObjectDataSource control puede filtrar los datos recuperados por el SelectMethod propiedad, si los datos se devuelven como un DataSet o DataTable objeto.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 el FilterExpression propiedad en una expresión de filtrado mediante el uso de un formato de sintaxis de cadena y enlazar los valores en la expresión para los parámetros que se especifican en el FilterParameters colección.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 SelectMethod propiedad.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 caché, las llamadas subsiguientes a la Select método devolver los datos en caché en lugar de crear el objeto de negocios 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. Almacenamiento en caché permite evitar crear el objeto y llamar a su método de datos a costa de la memoria en el servidor Web.Caching lets you avoid creating the object and calling its data method at the expense of memory on the Web server. El ObjectDataSource automáticamente almacena en caché datos cuando el EnableCaching propiedad está establecida en truey el CacheDuration propiedad está establecida en el número de segundos que la memoria caché almacena los datos antes de la caché se descarta.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 un CacheExpirationPolicy propiedad y un elemento opcional SqlCacheDependency propiedad.You can also specify a CacheExpirationPolicy property and an optional SqlCacheDependency property. El ObjectDataSource control le permite almacenar en caché todos los tipos de datos, pero no debe almacenar en caché objetos que conservarán los recursos o estado que no se pueden compartir para varias solicitudes de servicio (por ejemplo, una apertura SqlDataReader objeto), ya que la misma instancia del objeto se usará para atender las solicitudes múltiples.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 describe las características de la ObjectDataSource control.The following table describes the features of the ObjectDataSource control.

FunciónCapability RequisitosRequirements
SelecciónSelecting Establecer el SelectMethod propiedad en el nombre de la empresa método que selecciona datos de objeto e incluyen todos los parámetros necesarios en el SelectParameters colección mediante programación o mediante el uso de 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.
OrdenarSorting Establecer el SortParameterName propiedad en el nombre del parámetro en el SelectMethod método que lleva a cabo los criterios de ordenación.Set the SortParameterName property to the name of the parameter in the SelectMethod method that carries the sort criteria.
FiltradoFiltering Establecer el FilterExpression propiedad en una expresión de filtrado y, opcionalmente, agregue los parámetros para el FilterParameters colección para filtrar los datos cuando el Select se llama al método.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 el SelectMethod propiedad 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 la SelectMethod método contiene parámetros para el número máximo de registros para recuperar y el índice del primer registro que debe 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 el MaximumRowsParameterName y StartRowIndexParameterName propiedades, respectivamente.The names of those parameters must be set in the MaximumRowsParameterName and StartRowIndexParameterName properties, respectively. Un control enlazado a datos podría ser capaz de realizar la paginación por sí mismo, incluso si la ObjectDataSource control no admite la paginación directamente en el método especificado por el SelectMethod propiedad.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 para el control enlazado a datos poder hacer esto es que el método especificado por el SelectMethod propiedad devolver un objeto que implementa el ICollection interfaz.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.
UpdatingUpdating Establecer el UpdateMethod propiedad en el nombre de la empresa método que actualiza los datos del objeto e incluyen todos los parámetros necesarios en el UpdateParameters colección.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 Establecer el DeleteMethod propiedad en el nombre de la empresa método o función que elimina los datos de objeto e incluyen todos los parámetros necesarios en el DeleteParameters colección.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 Establecer el InsertMethod propiedad en el nombre de la empresa método o función que inserta datos de objeto e incluyen todos los parámetros necesarios en el InsertParameters colección.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 Establecer el EnableCaching propiedad truey el CacheDuration y CacheExpirationPolicy propiedades de acuerdo con el comportamiento de almacenamiento en caché que desea 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 el ObjectDataSource clase para actualizar o insertar datos, las cadenas que se escriben en el cliente no se convierten automáticamente en el formato de referencia cultural de cliente en el 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 de cliente podría especificar DD/MM/AAAA como el formato de fecha y el formato de fecha en el servidor podría ser DD/MM/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, tendría que escribirse en un TextBox controlar como 5/10/2009, pero se interpretaría como 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. 15 de octubre de 2009 se especificarí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 ObjectDataSource control 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. Mientras el ObjectDataSource control es la interfaz que el desarrollador de páginas que se usa para trabajar con datos, la ObjectDataSourceView clase es la interfaz que trabaja 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, el ObjectDataSourceView clase describe las capacidades de 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 ObjectDataSource control sólo tiene una asociada ObjectDataSourceView, y siempre se denomina DefaultView.The ObjectDataSource control has only one associated ObjectDataSourceView, and it is always named DefaultView. Mientras el ObjectDataSourceView objeto expuesto por el GetView método, muchas de sus propiedades y métodos se encapsula y expone directamente el ObjectDataSource control.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 ObjectDataSourceView objeto realiza las operaciones de datos, incluidas recuperar, insertar, actualizar, eliminar, filtrar y ordenar los datos.Behind the scenes, the ObjectDataSourceView object performs all data operations, including retrieving, inserting, updating, deleting, filtering, and sorting the data. Para obtener más información, vea ObjectDataSourceView.For more information, see ObjectDataSourceView.

Usar LINQ to SQLUsing LINQ to SQL

Puede usar el ObjectDataSource control con una clase LINQ to SQL.You can use the ObjectDataSource control with a LINQ to SQL class. Para ello, Establece el TypeName propiedad 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. Además, establecer el SelectMethod, UpdateMethod, InsertMethod, y DeleteMethod métodos a los métodos en 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 ObjectDisposing eventos con el fin de 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 aplazada, mientras que el ObjectDataSource control intenta eliminar el contexto de datos después de la operación de selección.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 LINQ a las clases SQL, vea Cómo: Crear clases 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 ObjectDisposing eventos.For an example of how to cancel the disposing of a data context class, see the ObjectDisposing event.

Uso de Entity FrameworkUsing the Entity Framework

También puede usar el ObjectDataSource control con Entity Framework.You can also use the ObjectDataSource control with the Entity Framework. Para obtener más información, consulte mediante Entity Framework y el ObjectDataSource Control.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() ObjectDataSource() ObjectDataSource() ObjectDataSource()

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

ObjectDataSource(String, String) ObjectDataSource(String, String) ObjectDataSource(String, String) 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 Adapter Adapter Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory 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.

(Inherited from Control)
BindingContainer BindingContainer BindingContainer BindingContainer

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

(Inherited from Control)
CacheDuration CacheDuration CacheDuration 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 CacheExpirationPolicy CacheExpirationPolicy 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 CacheKeyDependency CacheKeyDependency 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 ChildControlsCreated ChildControlsCreated 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.

(Inherited from Control)
ClientID ClientID ClientID ClientID

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

(Inherited from DataSourceControl)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

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

(Inherited from DataSourceControl)
ClientIDSeparator ClientIDSeparator ClientIDSeparator 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.

(Inherited from Control)
ConflictDetection ConflictDetection ConflictDetection 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 Context Context 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.

(Inherited from Control)
Controls Controls Controls 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.

(Inherited from DataSourceControl)
ConvertNullToDBNull ConvertNullToDBNull ConvertNullToDBNull ConvertNullToDBNull

Obtiene o establece un valor que indica si el control Parameter convierte automáticamente los valores de Value que se pasan a una operación de actualización, inserción o eliminación desde null al valor ObjectDataSource.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 DataItemContainer DataItemContainer 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.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer 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.

(Inherited from Control)
DataObjectTypeName DataObjectTypeName DataObjectTypeName 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 DeleteMethod DeleteMethod 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 DeleteParameters DeleteParameters 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 DesignMode DesignMode 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.

(Inherited from Control)
EnableCaching EnableCaching EnableCaching 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 EnablePaging EnablePaging 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 EnableTheming EnableTheming EnableTheming

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

(Inherited from DataSourceControl)
EnableViewState EnableViewState EnableViewState 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.

(Inherited from Control)
Events Events Events 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.

(Inherited from Control)
FilterExpression FilterExpression FilterExpression 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 FilterParameters FilterParameters 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 HasChildViewState HasChildViewState 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.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

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

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

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

(Inherited from Control)
ID ID ID 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.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

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

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

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

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

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

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

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

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

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

(Inherited from Control)
IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection 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.

(Inherited from DataSourceControl)
InsertMethod InsertMethod InsertMethod 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 InsertParameters InsertParameters 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 IsChildControlStateCleared IsChildControlStateCleared 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.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled 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.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID 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.

(Inherited from Control)
MaximumRowsParameterName MaximumRowsParameterName MaximumRowsParameterName 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 NamingContainer NamingContainer 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.

(Inherited from Control)
OldValuesParameterFormatString OldValuesParameterFormatString OldValuesParameterFormatString 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 Page Page 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.

(Inherited from Control)
Parent Parent Parent 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.

(Inherited from Control)
ParsingCulture ParsingCulture ParsingCulture 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 RenderingCompatibility RenderingCompatibility 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.

(Inherited from Control)
SelectCountMethod SelectCountMethod SelectCountMethod 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 SelectMethod SelectMethod 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 SelectParameters SelectParameters 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 Site Site 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.

(Inherited from Control)
SkinID SkinID SkinID SkinID

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

(Inherited from DataSourceControl)
SortParameterName SortParameterName SortParameterName 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 SqlCacheDependency SqlCacheDependency 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 StartRowIndexParameterName StartRowIndexParameterName 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 TemplateControl TemplateControl 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.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory 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.

(Inherited from Control)
TypeName TypeName TypeName 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 UniqueID UniqueID UniqueID

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

(Inherited from Control)
UpdateMethod UpdateMethod UpdateMethod 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 UpdateParameters UpdateParameters 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 ValidateRequestMode ValidateRequestMode 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.

(Inherited from Control)
ViewState ViewState ViewState 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.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase 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.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

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

(Inherited from Control)
Visible Visible Visible 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.

(Inherited from DataSourceControl)

Métodos

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) 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.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) 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.

(Inherited from Control)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) 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.

(Inherited from DataSourceControl)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

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

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) 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.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

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

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() 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.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() 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.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() 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.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() 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.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() 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.

(Inherited from Control)
CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

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

(Inherited from DataSourceControl)
DataBind() DataBind() DataBind() 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.

(Inherited from Control)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) 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.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() 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.

(Inherited from Control)
Delete() Delete() Delete() 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() Dispose() Dispose() 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.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

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

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() 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.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

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

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) 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.

(Inherited from DataSourceControl)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) 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.

(Inherited from Control)
Focus() Focus() Focus() Focus()

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

(Inherited from DataSourceControl)
GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

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

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(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.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) 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.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) 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.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) 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.

(Inherited from Control)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) 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.

(Inherited from Control)
GetView(String) GetView(String) GetView(String) 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() GetViewNames() GetViewNames() 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() HasControls() HasControls() HasControls()

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

(Inherited from DataSourceControl)
HasEvents() HasEvents() HasEvents() 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.

(Inherited from Control)
Insert() Insert() Insert() 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() IsLiteralContent() IsLiteralContent() IsLiteralContent()

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

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) 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.

(Inherited from Control)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

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

MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) 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.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) 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.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Genera el evento DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) 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) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Genera el evento Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Genera el evento PreRender.Raises the PreRender event.

(Inherited from Control)
OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Genera el evento Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

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

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) 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.

(Inherited from Control)
RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs) RaiseDataSourceChangedEvent(EventArgs)

Genera el evento DataSourceChanged.Raises the DataSourceChanged event.

(Inherited from DataSourceControl)
RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) 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.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) 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.

(Inherited from Control)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) 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.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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.

(Inherited from DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) 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.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

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

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

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

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) 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.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() 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.

(Inherited from Control)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

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

Select() Select() Select() 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) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) 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.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) 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.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) 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.

(Inherited from Control)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() 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() Update() Update() 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 DataBinding DataBinding 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.

(Inherited from Control)
Deleted Deleted Deleted Deleted

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

Deleting Deleting Deleting Deleting

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

Disposed Disposed Disposed 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.

(Inherited from Control)
Filtering Filtering Filtering Filtering

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

IDataSource.DataSourceChanged IDataSource.DataSourceChanged IDataSource.DataSourceChanged 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.

(Inherited from DataSourceControl)
Init Init Init 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.

(Inherited from Control)
Inserted Inserted Inserted Inserted

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

Inserting Inserting Inserting Inserting

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

Load Load Load 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.

(Inherited from Control)
ObjectCreated ObjectCreated ObjectCreated 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 ObjectCreating ObjectCreating 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 ObjectDisposing ObjectDisposing 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 PreRender PreRender 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.

(Inherited from Control)
Selected Selected Selected Selected

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

Selecting Selecting Selecting Selecting

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

Unload Unload Unload Unload

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

(Inherited from Control)
Updated Updated Updated Updated

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

Updating Updating Updating Updating

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

Implementaciones de interfaz explícitas

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

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

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

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

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

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

(Inherited from Control)
IDataSource.GetView(String) IDataSource.GetView(String) IDataSource.GetView(String) 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.

(Inherited from DataSourceControl)
IDataSource.GetViewNames() IDataSource.GetViewNames() IDataSource.GetViewNames() 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.

(Inherited from DataSourceControl)
IListSource.GetList() IListSource.GetList() IListSource.GetList() 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.

(Inherited from DataSourceControl)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

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

(Inherited from Control)

Extension Methods

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) 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) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) 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) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

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

GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) 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) GetMetaTable(IDataSource) GetMetaTable(IDataSource) 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) TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable) 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: