ObjectDataSourceView.SelectMethod Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя метода или функции, вызываемых элементом управления ObjectDataSourceView для извлечения данных.
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 для извлечения данных. Значение по умолчанию — пустая строка ("").
Примеры
В следующем примере кода показано, как GridView элемент управления может отображать данные с помощью ObjectDataSource элемента управления на странице веб-формы. идентифицирует ObjectDataSource частичное или полное имя класса с его TypeName свойством и методом, который вызывается для получения данных с помощью свойства SelectMethod . Во время выполнения создается объект , а метод вызывается с помощью отражения. Элемент GridView управления перечисляет коллекцию IEnumerable , возвращаемую SelectMethod, а затем отображает данные.
<%@ 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 таблице, чтобы элемент управления успешно вызывал его.
Возвращаемый тип | Действие |
---|---|
IEnumerable | Возвращается IEnumerable методом Select . |
DataTable | Создается DataView с помощью DataTable и возвращается методом Select . |
DataSet | Первый DataTable из DataSet извлекается, и DataView создается и возвращается методом Select . |
Object | Объект упаковывается в один элемент IEnumerable и возвращается методом Select . |
Метод, определяемый свойством SelectMethod , может быть методом экземпляра или методом static
(Shared
в Visual Basic). Если это метод экземпляра, бизнес-объект создается и уничтожается при каждом вызове SelectMethod метода. Вы можете обработать ObjectCreated событие для работы с бизнес-объектом до вызова метода, указанного свойством SelectMethod . Можно также обработать ObjectDisposing событие, которое возникает после вызова метода, указанного свойством SelectMethod . (Dispose
вызывается только в том случае, если бизнес-объект реализует IDisposable интерфейс.) Если метод является методом static
(Shared
в Visual Basic), бизнес-объект никогда не создается и вы не можете обрабатывать эти события.
Если бизнес-объект, с которым ObjectDataSource работает элемент управления, реализует несколько методов или функций с одинаковыми именами (перегрузки методов), элемент управления источником данных пытается вызвать правильный метод в соответствии с набором условий, включая параметры в SelectParameters коллекции. Если параметры в SelectParameters коллекции не совпадают с параметрами сигнатуры метода, указанного SelectMethod свойством , источник данных создает исключение.
Для получения дополнительной информации см. ObjectDataSource.SelectMethod.