ObjectDataSourceView.SelectMethod Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o nome do método ou função que o ObjectDataSourceView controlo invoca para recuperar dados.

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 Propriedade

String

Uma cadeia que representa o nome do método ou função que o ObjectDataSourceView utilizador utiliza para recuperar dados. O padrão é uma cadeia vazia ("").

Exemplos

O exemplo de código seguinte demonstra como um GridView controlo pode mostrar dados usando um ObjectDataSource controlo numa página Web Forms. Identifica ObjectDataSource um nome de classe parcial ou totalmente qualificado com a sua TypeName propriedade e um método que é chamado para recuperar dados com a sua SelectMethod propriedade. Em tempo de execução, o objeto é criado e o método é chamado usando reflexão. O GridView controlo enumera através da IEnumerable coleção que é devolvida pelo SelectMethod, e depois apresenta os dados.

<%@ 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>

Observações

O método especificado pode ter qualquer assinatura de método, mas deve devolver um dos tipos listados na tabela seguinte para que o ObjectDataSource controlo o chame com sucesso

Tipo de retorno Ação
IEnumerable O IEnumerable é devolvido pelo Select método.
DataTable A é criado usando o DataTable e devolvido DataView pelo Select método.
DataSet O primeiro DataTable dos DataSet é extraído e a DataView é criado e devolvido pelo Select método.
Object O objeto é envolto num elemento IEnumerable único e devolvido pelo Select método.

O método identificado pela propriedade SelectMethod pode ser um método de instância ou um método static (Shared em Visual Basic). Se for um método de instância, o objeto de negócio é criado e destruído cada vez que o SelectMethod método é chamado. Pode gerir o ObjectCreated evento para trabalhar com o objeto de negócio antes de o método especificado pela SelectMethod propriedade ser chamado. Também pode tratar do ObjectDisposing evento que é levantado após o método especificado pela SelectMethod propriedade ser chamado. (Dispose é chamada apenas se o objeto de negócio implementar a interface IDisposable.) Se o método for um método static (Shared em Visual Basic), o objeto de negócio nunca é criado e não pode lidar com estes eventos.

Se o objeto de negócio com que o ObjectDataSource controlo trabalha implementar mais do que um método ou função com o mesmo nome (sobrecarga de métodos), o controlo de fonte de dados tenta invocar o correto de acordo com um conjunto de condições, incluindo os parâmetros da SelectParameters coleção. Se os parâmetros na SelectParameters coleção não corresponderem aos da assinatura do método especificado pela SelectMethod propriedade, a fonte de dados lança uma exceção.

Para obter mais informações, veja ObjectDataSource.SelectMethod.

Aplica-se a

Ver também