ObjectDataSourceView.SelectMethod Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Lekéri vagy beállítja annak a metódusnak vagy függvénynek a nevét, amelyet a vezérlő meghív az ObjectDataSourceView adatok lekéréséhez.

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

Tulajdonság értéke

String

Egy sztring, amely annak a metódusnak vagy függvénynek a nevét jelöli, amelyet az ObjectDataSourceView adatok lekéréséhez használ. Az alapértelmezett érték egy üres sztring ("").

Példák

Az alábbi példakód bemutatja, hogy egy GridView vezérlő hogyan jeleníthet meg adatokat egy ObjectDataSource vezérlőelem használatával egy webűrlapon. A ObjectDataSource részben vagy teljesen minősített osztálynevet a tulajdonságával TypeName azonosítja, és egy metódust, amely meghívja az adatokat a tulajdonságával SelectMethod együtt. Futásidőben létrejön az objektum, és a metódust tükröződés használatával hívjuk meg. A GridView vezérlő számbavétele a gyűjteményen keresztül történik, amelyet a IEnumerable rendszer visszaad SelectMethod, majd megjeleníti az adatokat.

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

Megjegyzések

A megadott metódus bármilyen metódus-aláírással rendelkezhet, de a vezérlőelem sikeres meghívásához ObjectDataSource az alábbi táblázatban felsorolt típusok egyikét kell visszaadnia

Visszatérési típus Action
IEnumerable A IEnumerable metódus visszaadja a függvényt Select .
DataTable Az A DataView a metódussal DataTable jön létre, és visszaadja.Select
DataSet Az első ki DataTable lesz nyerve, és a DataSet metódus létrehozza és visszaadja az egyiket DataViewSelect.
Object Az objektum egy elembe IEnumerable van csomagolva, és a Select metódus adja vissza.

A SelectMethod tulajdonság által azonosított metódus lehet példánymetódus vagy static (Shared Visual Basic) metódus. Ha ez egy példánymetódus, az üzleti objektum minden alkalommal létrejön és megsemmisül, amikor a SelectMethod metódust meghívják. A tulajdonság által ObjectCreated megadott metódus meghívása előtt kezelheti az SelectMethod eseményt az üzleti objektummal való együttműködéshez. A tulajdonság által ObjectDisposing megadott metódus meghívása után létrehozott eseményt is kezelhetiSelectMethod. (Dispose csak akkor van meghívva, ha az üzleti objektum implementálja a IDisposable interfészt.) Ha a metódus egy static (Shared Visual Basic) metódus, az üzleti objektum soha nem jön létre, és nem tudja kezelni ezeket az eseményeket.

Ha a vezérlő által használt üzleti objektum ObjectDataSource egynél több metódust vagy függvényt valósít meg ugyanazzal a névvel (a metódus túlterhelt), az adatforrás-vezérlő megkísérli meghívni a megfelelőt egy feltételkészlet szerint, beleértve a SelectParameters gyűjtemény paramétereit is. Ha a gyűjtemény paraméterei nem egyeznek meg SelectParameters a tulajdonság által SelectMethod megadott metódus aláírásával, az adatforrás kivételt jelez.

További információért lásd ObjectDataSource.SelectMethod.

A következőre érvényes:

Lásd még