Sdílet prostřednictvím

ObjectDataSourceView.SelectMethod Vlastnost

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í ObjectDataSource ovládacího prvku na stránce Webové formuláře. 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 vyčíslí IEnumerable kolekci, která je vrácena 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, aby ObjectDataSource ovládací prvek mohl úspěšně volat.

Návratový typ Action
IEnumerable Metoda IEnumerable je vrácena Select .
DataTable Vytvoří se DataView pomocí DataTable metody a vrátí ji Select .
DataSet První DataTable z nich DataSet je extrahován a DataView je vytvořen a vrácen metodou Select .
Object Objekt je zabalený v jednom prvku IEnumerable a vrácen metodou Select .

Metoda, která je identifikována SelectMethod vlastností může být instance metoda nebo static (Shared v jazyce Visual Basic). Pokud se jedná o metodu instance, obchodní objekt se vytvoří a zničí při SelectMethod každém zavolání metody. Událost můžete zpracovat ObjectCreated 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 za metodou určenou SelectMethod vlastností je volána. (Dispose je volána pouze v případě, že obchodní objekt implementuje IDisposable rozhraní.) Pokud je metoda (staticSharedv 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 ten správný podle sady podmínek, včetně parametrů v kolekci SelectParameters . Pokud parametry v SelectParameters kolekci neodpovídají podpisu metody určené SelectMethod vlastností, zdroj dat vyvolá výjimku.

Další informace najdete na webu ObjectDataSource.SelectMethod.

Platí pro

Viz také