Condividi tramite

ObjectDataSourceView.SelectMethod Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta il nome del metodo o della funzione richiamato dal ObjectDataSourceView controllo per recuperare i dati.

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

Valore della proprietà

String

Stringa che rappresenta il nome del metodo o della funzione utilizzata ObjectDataSourceView da per recuperare i dati. Il valore predefinito è una stringa vuota ("").

Esempio

Nell'esempio di codice seguente viene illustrato come un GridView controllo può visualizzare i dati usando un ObjectDataSource controllo in una pagina Web Form. ObjectDataSource Identifica un nome di classe parzialmente o completo con la relativa TypeName proprietà e un metodo chiamato per recuperare i dati con la relativa SelectMethod proprietà. In fase di esecuzione, l'oggetto viene creato e il metodo viene chiamato usando la reflection. Il GridView controllo enumera la IEnumerable raccolta restituita da SelectMethode quindi visualizza i dati.

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

Commenti

Il metodo specificato può avere qualsiasi firma del metodo, ma deve restituire uno dei tipi elencati nella tabella seguente per consentire al ObjectDataSource controllo di chiamarlo correttamente

Tipo restituito Action
IEnumerable L'oggetto IEnumerable viene restituito dal Select metodo .
DataTable Un DataView oggetto viene creato utilizzando DataTable e restituito dal Select metodo .
DataSet Il primo DataTable oggetto DataSet viene estratto e viene DataView creato e restituito dal Select metodo .
Object L'oggetto viene sottoposto a wrapping in un elemento IEnumerable e restituito dal Select metodo .

Il metodo identificato dalla SelectMethod proprietà può essere un metodo di istanza o un static metodo (Shared in Visual Basic). Se si tratta di un metodo di istanza, l'oggetto business viene creato e eliminato definitivamente ogni volta che viene chiamato il SelectMethod metodo . È possibile gestire l'evento ObjectCreated per lavorare con l'oggetto business prima che venga chiamato il metodo specificato dalla SelectMethod proprietà . È anche possibile gestire l'evento ObjectDisposing generato dopo la chiamata del SelectMethod metodo specificato dalla proprietà . (Dispose viene chiamato solo se l'oggetto business implementa l'interfaccia IDisposable . Se il metodo è un static metodo (Shared in Visual Basic), l'oggetto business non viene mai creato e non è possibile gestire questi eventi.

Se l'oggetto business utilizzato dal ObjectDataSource controllo implementa più metodi o funzioni con lo stesso nome (overload del metodo), il controllo origine dati tenta di richiamare quello corretto in base a un set di condizioni, inclusi i parametri nell'insieme SelectParameters . Se i parametri nella SelectParameters raccolta non corrispondono a quelli della firma del metodo specificato dalla SelectMethod proprietà , l'origine dati genera un'eccezione.

Per altre informazioni, vedere ObjectDataSource.SelectMethod.

Si applica a

Vedi anche