ObjectDataSourceView.SelectMethod Proprietà

Definizione

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSourceView richiama per recuperare i dati.Gets or sets the name of the method or function that the ObjectDataSourceView control invokes to retrieve data.

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à

Stringa che rappresenta il nome del metodo o funzione che l'oggetto ObjectDataSourceView utilizza per recuperare i dati.A string that represents the name of the method or function that the ObjectDataSourceView uses to retrieve data. Il valore predefinito è una stringa vuota ("").The default is an empty string ("").

Esempi

Nell'esempio di codice seguente viene illustrato GridView il modo in cui un controllo ObjectDataSource può visualizzare i dati utilizzando un controllo in una pagina Web Form.The following code example demonstrates how a GridView control can display data using an ObjectDataSource control on a Web Forms page. 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à. ObjectDataSourceThe ObjectDataSource identifies a partially or fully qualified class name with its TypeName property and a method that is called to retrieve data with its SelectMethod property. In fase di esecuzione, l'oggetto viene creato e il metodo viene chiamato mediante reflection.At run time, the object is created and the method is called using reflection. Il GridView controllo enumera IEnumerable la raccolta restituita da SelectMethod, quindi Visualizza i dati.The GridView control enumerates through the IEnumerable collection that is returned by the SelectMethod, and then displays the data.

<%@ 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 una firma del metodo, ma deve restituire uno dei tipi elencati nella tabella seguente per consentire ObjectDataSource al controllo di chiamarlo correttamente.The specified method can have any method signature but must return one of the types listed in the following table in order for the ObjectDataSource control to call it successfully

Tipo restituitoReturn type OperazioneAction
IEnumerable IEnumerable Viene restituitoSelect dal metodo.The IEnumerable is returned by the Select method.
DataTable Un DataView oggetto viene creato DataTable usando e restituito dal Select metodo.A DataView is created using the DataTable and returned by the Select method.
DataSet Il primo DataTable DataSet oggetto di viene estratto e un DataView oggetto viene creato e restituito dal Select metodo.The first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object L'oggetto viene racchiuso in un elemento IEnumerable e restituito Select dal metodo.The object is wrapped in a one-element IEnumerable and returned by the Select method.

Il metodo identificato dalla SelectMethod proprietà può essere un metodo di istanza o un static metodo (Shared in Visual Basic).The method that is identified by the SelectMethod property can be an instance method or a static (Shared in Visual Basic) method. Se si tratta di un metodo di istanza, l'oggetto business viene creato ed eliminato ogni SelectMethod volta che viene chiamato il metodo.If it is an instance method, the business object is created and destroyed each time the SelectMethod method is called. È possibile gestire l' ObjectCreated evento in modo che funzioni con l'oggetto business prima che venga chiamato SelectMethod il metodo specificato dalla proprietà.You can handle the ObjectCreated event to work with the business object before the method specified by the SelectMethod property is called. È anche possibile gestire l' ObjectDisposing evento generato dopo la chiamata del metodo specificato SelectMethod dalla proprietà.You can also handle the ObjectDisposing event that is raised after the method specified by the SelectMethod property is called. viene chiamato solo se l'oggetto business implementa l' IDisposable interfaccia.Dispose Se il metodo è un static metodoShared (in Visual Basic), l'oggetto business non viene mai creato e non è possibile gestire questi eventi.(Dispose is called only if the business object implements the IDisposable interface.) If the method is a static (Shared in Visual Basic) method, the business object is never created and you cannot handle these events.

Se l'oggetto business con cui ObjectDataSource funziona il controllo implementa più di un metodo o funzione 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. SelectParameters nella raccolta.If the business object that the ObjectDataSource control works with implements more than one method or function with the same name (method overloads), the data source control attempts to invoke the correct one according to a set of conditions, including the parameters in the SelectParameters collection. Se i parametri nella SelectParameters raccolta non corrispondono a quelli della firma del metodo specificato SelectMethod dalla proprietà, l'origine dati genera un'eccezione.If the parameters in the SelectParameters collection do not match those of the signature of the method specified by the SelectMethod property, the data source throws an exception.

Per ulteriori informazioni, vedere ObjectDataSource.SelectMethod.For more information, see ObjectDataSource.SelectMethod.

Si applica a

Vedi anche