ObjectDataSourceView.SelectMethod Właściwość

Definicja

Pobiera lub ustawia nazwę metody lub funkcji, która ObjectDataSourceView wywołuje formant w celu pobrania danych.Gets or sets the name of the method or function that the ObjectDataSourceView control invokes to retrieve data.

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

Wartość właściwości

String

Ciąg, który reprezentuje nazwę metody lub funkcji, której ObjectDataSourceView używa do pobierania danych.A string that represents the name of the method or function that the ObjectDataSourceView uses to retrieve data. Wartością domyślną jest ciąg pusty ("").The default is an empty string ("").

Przykłady

Poniższy przykład kodu demonstruje, jak GridView kontrolka może wyświetlać dane przy użyciu ObjectDataSource kontrolki na stronie formularzy sieci Web.The following code example demonstrates how a GridView control can display data using an ObjectDataSource control on a Web Forms page. ObjectDataSourceIdentyfikuje częściowo lub w pełni kwalifikowaną nazwę klasy z TypeName właściwością i metodę, która jest wywoływana, aby pobrać dane z SelectMethod właściwością.The ObjectDataSource identifies a partially or fully qualified class name with its TypeName property and a method that is called to retrieve data with its SelectMethod property. W czasie wykonywania obiekt jest tworzony, a metoda jest wywoływana przy użyciu odbicia.At run time, the object is created and the method is called using reflection. GridViewKontrolka wylicza IEnumerable kolekcję, która jest zwracana przez SelectMethod , a następnie wyświetla dane.The GridView control enumerates through the IEnumerable collection that is returned by the SelectMethod, and then displays the 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>

Uwagi

Określona metoda może mieć dowolny podpis metody, ale musi zwrócić jeden z typów wymienionych w poniższej tabeli, aby ObjectDataSource formant mógł pomyślnie wywołać ten elementThe specified method can have any method signature but must return one of the types listed in the following table in order for the ObjectDataSource control to call it successfully

Typ zwracanyReturn type AkcjaAction
IEnumerable IEnumerableJest zwracany przez Select metodę.The IEnumerable is returned by the Select method.
DataTable Obiekt DataView jest tworzony przy użyciu DataTable i zwracany przez Select metodę.A DataView is created using the DataTable and returned by the Select method.
DataSet Pierwszy DataTable z nich DataSet jest wyodrębniany i DataView jest tworzony i zwracany przez Select metodę.The first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object Obiekt jest opakowany w jeden element IEnumerable i zwracany przez Select metodę.The object is wrapped in a one-element IEnumerable and returned by the Select method.

Metodą identyfikowaną przez SelectMethod Właściwość może być metoda wystąpienia lub static Shared metoda (w Visual Basic).The method that is identified by the SelectMethod property can be an instance method or a static (Shared in Visual Basic) method. Jeśli jest to metoda wystąpienia, obiekt biznesowy jest tworzony i niszczony za każdym razem, gdy SelectMethod wywoływana jest metoda.If it is an instance method, the business object is created and destroyed each time the SelectMethod method is called. Możesz obsłużyć ObjectCreated zdarzenie do pracy z obiektem biznesowym przed wywołaniem metody określonej przez SelectMethod Właściwość.You can handle the ObjectCreated event to work with the business object before the method specified by the SelectMethod property is called. Można także obsłużyć ObjectDisposing zdarzenie wywoływane po wywołaniu metody określonej przez SelectMethod Właściwość.You can also handle the ObjectDisposing event that is raised after the method specified by the SelectMethod property is called. ( Dispose jest wywoływana tylko wtedy, gdy obiekt biznesowy implementuje IDisposable interfejs). Jeśli metoda jest static Shared metodą (w Visual Basic), obiekt biznesowy nigdy nie jest tworzony i nie będzie można obsługiwać tych zdarzeń.(Dispose is called only if the business object implements the IDisposable interface.) If the method is a static (Shared in Visual Basic) method, the business object is never created and you cannot handle these events.

Jeśli obiekt biznesowy, ObjectDataSource z którym działa kontrolka implementuje więcej niż jedną metodę lub funkcję o tej samej nazwie (przeciążenia metod), kontrola źródła danych próbuje wywołać poprawną wartość przy użyciu zestawu warunków, w tym parametrów w SelectParameters kolekcji.If the business object that the ObjectDataSource control works with implements more than one method or function with the same name (method overloads), the data source control attempts to invoke the correct one according to a set of conditions, including the parameters in the SelectParameters collection. Jeśli parametry w SelectParameters kolekcji nie są zgodne z podpisem metody określonej przez SelectMethod Właściwość, źródło danych zgłasza wyjątek.If the parameters in the SelectParameters collection do not match those of the signature of the method specified by the SelectMethod property, the data source throws an exception.

Aby uzyskać więcej informacji, zobacz ObjectDataSource.SelectMethod.For more information, see ObjectDataSource.SelectMethod.

Dotyczy

Zobacz też