ObjectDataSourceView.SelectMethod Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el nombre del método o función a los que invoca el control ObjectDataSourceView para recuperar datos.

public:
 property System::String ^ SelectMethod { System::String ^ get(); void set(System::String ^ value); };
public string SelectMethod { get; set; }
member this.SelectMethod : string with get, set
Public Property SelectMethod As String

Valor de propiedad

String

Cadena que representa el nombre del método o función que usa el objeto ObjectDataSourceView para recuperar datos. El valor predeterminado es una cadena vacía ("").

Ejemplos

En el ejemplo de código siguiente se muestra cómo un GridView control puede mostrar datos mediante un ObjectDataSource control en una página de Web Forms. ObjectDataSource identifica un nombre de clase parcial o completo con su TypeName propiedad y un método al que se llama para recuperar datos con su SelectMethod propiedad . En tiempo de ejecución, se crea el objeto y se llama al método mediante reflexión. El GridView control enumera a través de la IEnumerable colección devuelta por SelectMethody, a continuación, muestra los datos.

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

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

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

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

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

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

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

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

Comentarios

El método especificado puede tener cualquier firma de método, pero debe devolver uno de los tipos enumerados en la tabla siguiente para que el ObjectDataSource control lo llame correctamente.

Tipo de valor devuelto Acción
IEnumerable El IEnumerable método devuelve .Select
DataTable DataView Se crea mediante y DataTable devuelve el Select método .
DataSet El primero DataTable de DataSet se extrae y se crea y DataView devuelve mediante el Select método .
Object El objeto se ajusta en un elemento IEnumerable uno y lo devuelve el Select método .

El método identificado por la SelectMethod propiedad puede ser un método de instancia o un static método (Shared en Visual Basic). Si es un método de instancia, el objeto de negocio se crea y destruye cada vez que se llama al SelectMethod método . Puede controlar el ObjectCreated evento para trabajar con el objeto de negocio antes de llamar al método especificado por la SelectMethod propiedad . También puede controlar el ObjectDisposing evento que se genera después de llamar al método especificado por la SelectMethod propiedad . (Dispose solo se llama si el objeto de negocio implementa la IDisposable interfaz ). Si el método es un static método (Shared en Visual Basic), el objeto de negocio nunca se crea y no se pueden controlar estos eventos.

Si el objeto de negocio con el que funciona el ObjectDataSource control implementa más de un método o función con el mismo nombre (sobrecargas de método), el control de origen de datos intenta invocar el correcto según un conjunto de condiciones, incluidos los parámetros de la SelectParameters colección. Si los parámetros de la SelectParameters colección no coinciden con los de la firma del método especificado por la SelectMethod propiedad , el origen de datos produce una excepción.

Para obtener más información, vea ObjectDataSource.SelectMethod.

Se aplica a

Consulte también