ObjectDataSourceView.SelectMethod Свойство

Определение

Получает или задает имя метода или функции, вызываемых элементом управления ObjectDataSourceView для извлечения данных.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

Значение свойства

Строка, представляющая имя метода или функции, используемых элементом управления ObjectDataSourceView для извлечения данных.A string that represents the name of the method or function that the ObjectDataSourceView uses to retrieve data. Значение по умолчанию — пустая строка ("").The default is an empty string ("").

Примеры

В следующем примере кода показано, как GridView элемент управления может отображать данные ObjectDataSource с помощью элемента управления на странице веб-форм.The following code example demonstrates how a GridView control can display data using an ObjectDataSource control on a Web Forms page. Определяет частичное или полное имя класса TypeName со свойством и методом, который вызывается SelectMethod для получения данных со свойством. ObjectDataSourceThe 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. Во время выполнения создается объект, и метод вызывается с помощью отражения.At run time, the object is created and the method is called using reflection. Элемент управления перечисляет IEnumerable коллекциюSelectMethod, возвращаемую, а затем отображает данные. GridViewThe 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>

Комментарии

Указанный метод может иметь любую сигнатуру метода, но должен возвращать один из типов, перечисленных в следующей таблице ObjectDataSource , чтобы элемент управления мог успешно его вызвать.The 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

Возвращаемый типReturn type ДействиеAction
IEnumerable МетодвозвращаетсяSelectметодом. IEnumerableThe IEnumerable is returned by the Select method.
DataTable Создается с помощью Selectивозвращаетсяметодом. DataTable DataViewA DataView is created using the DataTable and returned by the Select method.
DataSet Первый DataTable DataView из извлекается и создается и возвращается Select методом. DataSetThe first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object Объект упаковывается в один элемент IEnumerable и возвращается Select методом.The object is wrapped in a one-element IEnumerable and returned by the Select method.

Метод, идентифицируемый SelectMethod свойством, может быть методом экземпляра static или методом (Shared в Visual Basic).The method that is identified by the SelectMethod property can be an instance method or a static (Shared in Visual Basic) method. Если это метод экземпляра, бизнес-объект создается и уничтожается каждый раз SelectMethod при вызове метода.If it is an instance method, the business object is created and destroyed each time the SelectMethod method is called. Вы можете ObjectCreated обойти событие, чтобы работать с бизнес-объектом до вызова метода, указанного SelectMethod свойством.You can handle the ObjectCreated event to work with the business object before the method specified by the SelectMethod property is called. Можно также выполнить обработку ObjectDisposing события, возникающего после вызова метода, заданного SelectMethod свойством.You can also handle the ObjectDisposing event that is raised after the method specified by the SelectMethod property is called. (Dispose вызывается только в том случае, если бизнес IDisposable -объект реализует интерфейс.) Если метод является static методом (Shared в Visual Basic), бизнес-объект никогда не создается, и эти события не могут быть обработаны.(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.

Если бизнес-объект, с ObjectDataSource которым работает элемент управления, реализует несколько методов или функций с одним и тем же именем (перегрузки метода), элемент управления источника данных пытается вызвать правильное значение в соответствии с набором условий, включая параметры. SelectParameters в коллекции.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. Если параметры в SelectParameters коллекции не соответствуют параметрам сигнатуры метода, заданного SelectMethod свойством, то источник данных создает исключение.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.

Для получения дополнительной информации см. ObjectDataSource.SelectMethod.For more information, see ObjectDataSource.SelectMethod.

Применяется к

Дополнительно