ObjectDataSourceView.SelectMethod Proprietà

  • Riferimento

Definizione

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

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSourceView richiama 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 funzione che l'oggetto ObjectDataSourceView utilizza per recuperare i dati. Il valore predefinito è una stringa vuota ("").

Esempio

Nell'esempio di codice seguente viene illustrato come un controllo può visualizzare i dati usando un GridViewObjectDataSource controllo in una pagina di Web Forms. Identifica ObjectDataSource 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 reflection. Il GridView controllo enumera tramite la IEnumerable raccolta restituita dall'oggetto 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 Azione
IEnumerable Viene IEnumerable restituito dal Select metodo .
DataTable Viene DataView creato usando e DataTable restituito dal Select metodo .
DataSet Il primo DataTable oggetto DataSet viene estratto e viene DataView creato e restituito dal Select metodo .
Object L'oggetto Select viene sottoposto a wrapping in un elemento IEnumerable uno e restituito dal 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 ogni volta che viene chiamato il SelectMethod metodo. È possibile gestire l'evento ObjectCreated per usare l'oggetto business prima che venga chiamato il SelectMethod metodo specificato dalla 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 usato dal controllo implementa più di un metodo o una funzione con lo stesso nome (overload del metodo), il ObjectDataSource controllo origine dati tenta di richiamare quello corretto in base a un set di condizioni, inclusi i parametri della SelectParameters raccolta. Se i parametri della 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