ObjectDataSourceView.SelectMethod Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSourceView-Steuerelement zum Abrufen von Daten aufgerufen wird, oder legt diesen fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die den Namen der Methode oder der Funktion darstellt, mit deren Hilfe die ObjectDataSourceView Daten abruft. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein GridView Steuerelement Daten mithilfe eines Steuerelements ObjectDataSource auf einer Web Forms Seite anzeigen kann. Der ObjectDataSource identifiziert einen teilweise oder vollqualifizierten Klassennamen mit seiner TypeName -Eigenschaft und einer Methode, die aufgerufen wird, um Daten mit seiner SelectMethod -Eigenschaft abzurufen. Zur Laufzeit wird das -Objekt erstellt, und die -Methode wird mithilfe von Reflektion aufgerufen. Das GridView -Steuerelement listet die IEnumerable Auflistung auf, die vom SelectMethodzurückgegeben wird, und zeigt dann die Daten an.

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

Hinweise

Die angegebene Methode kann über eine beliebige Methodensignatur verfügen, muss jedoch einen der in der folgenden Tabelle aufgeführten Typen zurückgeben, damit das ObjectDataSource Steuerelement sie erfolgreich aufrufen kann.

Rückgabetyp	Aktion
IEnumerable	Wird IEnumerable von der Select -Methode zurückgegeben.
DataTable	Ein DataView wird mit dem DataTable erstellt und von der Select -Methode zurückgegeben.
DataSet	Die erste DataTable der DataSet wird extrahiert, und ein DataView wird erstellt und von der Select -Methode zurückgegeben.
Object	Das Objekt wird in ein Ein-Element IEnumerable umschlossen und von der Select -Methode zurückgegeben.

Die Methode, die durch die SelectMethod -Eigenschaft identifiziert wird, kann eine instance-Methode oder eine static (Shared in Visual Basic) -Methode sein. Wenn es sich um eine instance-Methode handelt, wird das Geschäftsobjekt bei jedem Aufruf der SelectMethod Methode erstellt und zerstört. Sie können das ObjectCreated Ereignis behandeln, um mit dem Geschäftsobjekt zu arbeiten, bevor die von der SelectMethod -Eigenschaft angegebene Methode aufgerufen wird. Sie können auch das ObjectDisposing Ereignis behandeln, das ausgelöst wird, nachdem die durch die SelectMethod -Eigenschaft angegebene Methode aufgerufen wurde. (Dispose wird nur aufgerufen, wenn das Geschäftsobjekt die IDisposable -Schnittstelle implementiert.) Wenn es sich bei der Methode um eine static (Shared in Visual Basic)-Methode handelt, wird das Geschäftsobjekt nie erstellt, und Sie können diese Ereignisse nicht verarbeiten.

Wenn das Geschäftsobjekt, mit dem das ObjectDataSource Steuerelement arbeitet, mehr als eine Methode oder Funktion mit demselben Namen (Methodenüberladungen) implementiert, versucht das Datenquellensteuerelement, die richtige methode gemäß einer Reihe von Bedingungen aufzurufen, einschließlich der Parameter in der SelectParameters Auflistung. Wenn die Parameter in der SelectParameters Auflistung nicht mit denen der Signatur der von der SelectMethod -Eigenschaft angegebenen Methode übereinstimmen, löst die Datenquelle eine Ausnahme aus.

Weitere Informationen finden Sie unter ObjectDataSource.SelectMethod.

Gilt für:

Freigeben über