ObjectDataSourceView.SelectMethod Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.