ObjectDataSourceView.SelectMethod Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSourceView Steuerelement aufruft, um Daten abzurufen.
public:
property System::String ^ SelectMethod { System::String ^ get(); void set(System::String ^ value); };public string SelectMethod { get; set; }member this.SelectMethod : string with get, setPublic Property SelectMethod As StringEigenschaftswert
Eine Zeichenfolge, die den Namen der Methode oder Funktion darstellt, die zum ObjectDataSourceView Abrufen von Daten verwendet wird. Der Standardwert ist eine leere Zeichenfolge ("").
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie ein GridView Steuerelement Daten mithilfe eines ObjectDataSource Steuerelements auf einer Web Forms-Seite anzeigen kann. Der ObjectDataSource Identifiziert einen teilweisen 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 Spiegelung aufgerufen. Das GridView Steuerelement listet die IEnumerable Auflistung auf, die von dem SelectMethodSteuerelement zurü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 eine beliebige Methodensignatur aufweisen, muss jedoch einen der in der folgenden Tabelle aufgeführten Typen zurückgeben, damit das ObjectDataSource Steuerelement es erfolgreich aufrufen kann.
| Rückgabetyp | Action |
|---|---|
| IEnumerable | Dies IEnumerable wird von der Select Methode zurückgegeben. |
| DataTable | A DataView wird mithilfe der DataTable Methode erstellt und von dieser Select zurückgegeben. |
| DataSet | Der erste DataTable der DataSet extrahierten Und eine DataView wird von der Select Methode erstellt und zurückgegeben. |
| Object | Das Objekt wird in ein 1-Element IEnumerable eingeschlossen und von der Select Methode zurückgegeben. |
Die von der SelectMethod Eigenschaft identifizierte Methode kann eine Instanzmethode oder eine static (Shared in Visual Basic)-Methode sein. Wenn es sich um eine Instanzmethode handelt, wird das Geschäftsobjekt erstellt und jedes Mal zerstört, wenn die SelectMethod Methode aufgerufen wird. Sie können das ObjectCreated Ereignis behandeln, um mit dem Geschäftsobjekt zu arbeiten, bevor die durch die 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 behandeln.
Wenn das Geschäftsobjekt, mit dem das ObjectDataSource Steuerelement arbeitet, mehrere Methoden oder Funktionen mit demselben Namen (Methodenüberladungen) implementiert, versucht das Datenquellensteuerelement, die richtige methode gemäß einer Reihe von Bedingungen, einschließlich der Parameter in der SelectParameters Auflistung, aufzurufen. Wenn die Parameter in der SelectParameters Auflistung nicht mit denen der Signatur der durch die SelectMethod Eigenschaft angegebenen Methode übereinstimmen, löst die Datenquelle eine Ausnahme aus.
Weitere Informationen finden Sie unter ObjectDataSource.SelectMethod.
