ObjectDataSourceView.SelectMethod Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSourceView ovládací prvek vyvolá k načtení dat.

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

Hodnota vlastnosti

String

Řetězec, který představuje název metody nebo funkce, kterou ObjectDataSourceView používá k načtení dat. Výchozí hodnota je prázdný řetězec ("").

Příklady

Následující příklad kódu ukazuje, jak GridView ovládací prvek může zobrazit data pomocí ovládacího ObjectDataSource prvku na Web Forms stránce. Identifikuje ObjectDataSource částečně nebo plně kvalifikovaný název třídy s jeho TypeName vlastností a metodu, která je volána k načtení dat s jeho SelectMethod vlastností. Za běhu se objekt vytvoří a metoda se volá pomocí reflexe. Ovládací GridView prvek provede výčet prostřednictvím IEnumerable kolekce, která je vrácena objektem SelectMethoda pak zobrazí 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>

Poznámky

Zadaná metoda může mít libovolný podpis metody, ale musí vrátit jeden z typů uvedených v následující tabulce, ObjectDataSource aby ji ovládací prvek mohl úspěšně volat.

Návratový typ Akce
IEnumerable Metoda IEnumerable vrátí Select parametr .
DataTable Vytvoří DataView se pomocí DataTable metody a vrátí ji Select metoda.
DataSet První DataTable z DataSet je extrahován a DataView je vytvořen a vrácen metodou Select .
Object Objekt je zabalen do jednoho prvku IEnumerable a vrácen metodou Select .

Metoda identifikovaná SelectMethod vlastností může být metoda instance nebo static metoda (Shared v jazyce Visual Basic). Pokud se jedná o metodu instance, obchodní objekt se vytvoří a zničí při každém zavolání SelectMethod metody. Můžete zpracovat ObjectCreated událost pro práci s obchodním objektem před metodou určenou SelectMethod vlastností je volána. Můžete také zpracovat ObjectDisposing událost, která je vyvolána po zavolání metody určené SelectMethod vlastností. (Dispose je volána pouze v případě, že obchodní objekt implementuje IDisposable rozhraní.) Pokud je static metoda metoda (Shared v jazyce Visual Basic), obchodní objekt se nikdy nevytvořil a tyto události nelze zpracovat.

Pokud obchodní objekt, se kterým ObjectDataSource ovládací prvek pracuje, implementuje více než jednu metodu nebo funkci se stejným názvem (přetížení metody), pokusí se ovládací prvek zdroje dat vyvolat správnou metodu podle sady podmínek, včetně parametrů v kolekci SelectParameters . Pokud parametry v kolekci SelectParameters neodpovídají parametrům podpisu metody určené SelectMethod vlastností, zdroj dat vyvolá výjimku.

Další informace naleznete v tématu ObjectDataSource.SelectMethod.

Platí pro

Viz také