ObjectDataSourceView Класс

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

ObjectDataSource Поддерживает элемент управления и предоставляет интерфейс для элементов управления, привязанных к данным, для выполнения операций с бизнес-объектами и объектами данных.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager

Наследование: Object

DataSourceView
ObjectDataSourceView

Реализации: IStateManager

Класс ObjectDataSourceView реализует функции данных для ObjectDataSource элемента управления, включая Selectоперации, Update Delete Insert операции, сортировку, фильтрацию и управление параметрами, хранящиеся в состоянии просмотра.

Объект ObjectDataSourceView создается для каждого экземпляра ObjectDataSource класса во время выполнения. Вызовы операций с данными экземпляра ObjectDataSource класса обрабатываются экземпляром ObjectDataSourceView объекта. Разработчики страницы напрямую не обращаются к экземпляру ObjectDataSourceView класса. Разработчики элементов управления могут создавать пользовательские элементы управления данными, расширяя ObjectDataSource их и ObjectDataSourceView классы.

Класс ObjectDataSourceView выполняет операции с данными, вызывая методы для бизнес-объектов или объектов данных с помощью отражения. Во время ObjectDataSource выполнения элемент управления создает экземпляр типа, определяемого TypeName свойством, а затем вызывает соответствующий метод для операции данных. Экземпляр объекта не кэшируется в памяти ObjectDataSourceView. Объект создается и уничтожается для каждого вызова метода данных. Если метод имеет значение static (Shared в Visual Basic), экземпляр не создается, но метод операции данных по-прежнему вызывается.

Он ObjectDataSourceView не предоставляется разработчикам страницы напрямую с помощью ObjectDataSource элемента управления. Вместо этого свойства и методы ObjectDataSourceView доступа к ней получают доступ ObjectDataSource. Например, DeleteMethod ObjectDataSourceView свойство задается путем задания DeleteMethod свойства ObjectDataSourceобъекта .

Получение данных

Основная операция, выполняемая представлением источника данных, — получение данных из базового хранилища данных с помощью Select метода, которое извлекает IEnumerable коллекцию элементов данных. Следующие методы извлечения данных, свойства и события реализуются ObjectDataSourceView объектом и предоставляются непосредственно его ObjectDataSource элементом управления разработчикам страниц и другим вызывающим объектам:

Метод Select
Свойство SelectMethod
Свойство SelectParameters
Событие Selecting
Событие Selected

Обновление данных

Объект ObjectDataSourceView поддерживает обновления данных путем вызова метода бизнес-объекта или объекта данных, определяемого UpdateMethod свойством. Элементы управления с привязкой к данным, которые автоматически выполняют обновления, такие как GridView и DetailsView элементы управления, передают их параметры в интерфейсеObjectDataSourceView, IOrderedDictionary а объект представления объединяет эти параметры с любыми параметрами, найденными в UpdateParameters коллекции.

Следующие методы обновления, свойства и события реализуются ObjectDataSourceView и предоставляются непосредственно его ObjectDataSource элементом управления разработчикам страниц и другим вызывающим объектам:

Метод Update
Свойство UpdateMethod
Свойство UpdateParameters
Событие Updating
Событие Updated

Вставка данных

Объект ObjectDataSourceView поддерживает вставку новых строк данных путем вызова метода бизнес-объекта или объекта данных, определяемого InsertMethod свойством. Элементы управления с привязкой к данным, которые автоматически выполняют вставки, такие как GridView иDetailsView, передают их параметры в интерфейсObjectDataSourceView, IOrderedDictionary а объект представления объединяет эти параметры с любыми параметрами, найденными в InsertParameters коллекции.

Следующие методы вставки, свойства и события реализуются ObjectDataSourceView и предоставляются непосредственно его ObjectDataSource элементом управления разработчикам страниц и другим вызывающим объектам:

Метод Insert
Свойство InsertMethod
Свойство InsertParameters
Событие Inserting
Событие Inserted

Удаление данных

Объект ObjectDataSourceView поддерживает удаление данных путем вызова метода бизнес-объекта или объекта данных, определяемого свойством DeleteMethod . Элементы управления с привязкой к данным, которые автоматически выполняют удаления, такие как GridView иDetailsView, передают их параметры в интерфейсеObjectDataSourceView, IOrderedDictionary а объект представления объединяет эти параметры с любыми параметрами, найденными в DeleteParameters коллекции. Следующие методы удаления, свойства и события реализуются ObjectDataSourceView и предоставляются непосредственно его ObjectDataSource элементом управления разработчикам страниц и другим вызывающим объектам:

Метод Delete
Свойство DeleteMethod
Свойство DeleteParameters
Событие Deleting
Событие Deleted

Фильтрация и сортировка данных

Получение данных является более мощным, если можно динамически фильтровать данные. Фильтрация поддерживается только элементом ObjectDataSource управления, если Select метод возвращает DataTable объект или DataSet объект. Вы можете использовать FilterExpression свойства и FilterParameters свойства для применения динамической фильтрации к извлечению данных. Эти свойства реализуются ObjectDataSourceView объектом и предоставляются непосредственно его ObjectDataSource элементом управления для элементов управления, привязанных к данным, и других вызывающих элементов управления.

Вы можете отсортировать полученные данные с ObjectDataSource помощью упорядочивания данных в памяти после получения. Сортировка поддерживается только элементом ObjectDataSource управления, если Select метод возвращает DataTable или DataSet. Свойство CanSort всегда возвращается true, так как ObjectDataSourceView не удается определить, какой тип возвращается Select методом, не вызывая метод. Синтаксис SortExpression свойства совпадает с синтаксисом DataView.Sort свойства.

Отслеживание состояния представления

IStateManager Реализует ObjectDataSourceView интерфейс и использует состояние просмотра для отслеживания состояния страницы. LoadViewStateРеализация и SaveViewState TrackViewState методы предоставляются для включения отслеживания состояния просмотра для элемента управления. Дополнительные сведения см. в ASP.NET обзоре управления состояниями.

Конструкторы

Имя	Описание
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Инициализирует новый экземпляр класса ObjectDataSourceView.

Свойства

Имя	Описание
CanDelete	Возвращает значение, указывающее, поддерживает ли ObjectDataSourceView объект, связанный с текущим ObjectDataSource элементом управления, операцию удаления.
CanInsert	Возвращает значение, указывающее, поддерживает ли ObjectDataSourceView объект, связанный с текущим ObjectDataSource элементом управления, операцию вставки.
CanPage	Возвращает значение, указывающее, поддерживает ли ObjectDataSourceView объект, связанный с текущим ObjectDataSource элементом управления, разбиение по страницам по извлеченным данным.
CanRetrieveTotalRowCount	Возвращает значение, указывающее, поддерживает ли ObjectDataSourceView объект, связанный с текущим ObjectDataSource элементом управления, получение общего количества строк данных в дополнение к набору данных.
CanSort	Возвращает значение, указывающее, поддерживает ли ObjectDataSourceView объект, связанный с текущим ObjectDataSource элементом управления, отсортированный представление в базовом источнике данных.
CanUpdate	Возвращает значение, указывающее, поддерживает ли ObjectDataSourceView объект, связанный с текущим ObjectDataSource элементом управления, операцию обновления.
ConflictDetection	Возвращает или задает значение, определяющее, как ObjectDataSource элемент управления выполняет обновления и удаляет данные в строке в базовом хранилище данных во время операции.
ConvertNullToDBNull	Возвращает или задает значение, указывающее, передаются ли Parameter значения в операцию обновления, вставки или удаления автоматически преобразуются в `null`Value значение.
DataObjectTypeName	Возвращает или задает имя класса, который ObjectDataSource элемент управления использует для параметра в операции данных. Элемент ObjectDataSource управления использует указанный класс вместо Parameter объектов, которые находятся в различных коллекциях параметров.
DeleteMethod	Возвращает или задает имя метода или функции, вызываемой ObjectDataSourceView объектом для удаления данных.
DeleteParameters	Возвращает коллекцию параметров, содержащую параметры, используемые методом DeleteMethod .
EnablePaging	Возвращает или задает значение, указывающее, поддерживает ли элемент управления версиями данных разбиение по страницам с помощью набора полученных данных.
Events	Возвращает список делегатов обработчика событий для представления источника данных. (Унаследовано от DataSourceView)
FilterExpression	Возвращает или задает выражение фильтрации, применяемое при вызове метода бизнес-объекта, определяемого свойством SelectMethod .
FilterParameters	Возвращает коллекцию параметров, связанных с любыми заполнителями параметров, которые находятся в строке FilterExpression .
InsertMethod	Возвращает или задает имя метода или функции, вызываемой ObjectDataSourceView объектом для вставки данных.
InsertParameters	Возвращает коллекцию параметров, содержащую параметры, используемые методом InsertMethod .
IsTrackingViewState	Возвращает значение, указывающее, сохраняет ли ObjectDataSourceView объект изменения в состоянии представления.
MaximumRowsParameterName	Возвращает или задает имя параметра метода извлечения данных, который используется для указания количества записей, извлекаемых для поддержки разбиения по страницам источника данных.
Name	Возвращает имя представления источника данных. (Унаследовано от DataSourceView)
OldValuesParameterFormatString	Возвращает или задает строку формата, которая применяется к именам параметров для исходных значений, передаваемых `Delete` в методы или `Update` методы.
ParsingCulture	Возвращает или задает значение, указывающее, какие сведения о языке и региональных параметрах используются при преобразовании строковых значений в фактические типы свойств для создания объекта типа, указанного в параметре DataObjectTypeName.
SelectCountMethod	Возвращает или задает имя метода или функции, вызываемой ObjectDataSourceView элементом управления для получения количества строк.
SelectMethod	Возвращает или задает имя метода или функции, вызываемой ObjectDataSourceView элементом управления для получения данных.
SelectParameters	Возвращает коллекцию параметров, содержащую параметры, используемые методом SelectMethod .
SortParameterName	Возвращает или задает имя параметра метода извлечения данных, который используется для указания выражения сортировки для поддержки сортировки источников данных.
StartRowIndexParameterName	Возвращает или задает имя параметра метода извлечения данных, который используется для указания целочисленного индекса первой записи, извлекаемой из набора результатов для поддержки разбиения по страницам источника данных.
TypeName	Возвращает или задает имя класса, представляющего ObjectDataSource элемент управления.
UpdateMethod	Возвращает или задает имя метода или функции, вызываемой ObjectDataSourceView объектом для обновления данных.
UpdateParameters	Возвращает коллекцию параметров, содержащую параметры, используемые методом UpdateMethod .

Методы

Имя	Описание
CanExecute(String)	Определяет, может ли выполняться указанная команда. (Унаследовано от DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет асинхронную операцию удаления в списке данных, которые DataSourceView представляет объект. (Унаследовано от DataSourceView)
Delete(IDictionary, IDictionary)	Выполняет операцию удаления, вызвав метод бизнес-объекта, который определяется DeleteMethod свойством с помощью указанных `keys` и `oldValues` коллекций.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет указанную команду. (Унаследовано от DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Выполняет указанную команду. (Унаследовано от DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Выполняет операцию удаления с помощью DeleteMethod метода и указанной `keys` и `oldValues` коллекции.
ExecuteInsert(IDictionary)	Выполняет операцию вставки, вызвав метод бизнес-объекта, который определяется InsertMethod свойством с помощью указанной `values` коллекции.
ExecuteSelect(DataSourceSelectArguments)	Извлекает данные из объекта, определяемого TypeName свойством, путем вызова метода, определяемого SelectMethod свойством, и передачи любых значений SelectParameters в коллекции.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Выполняет операцию обновления путем вызова метода, определяемого свойствомUpdateMethod, и используя все параметры, предоставленные в `keys`коллекциях или `valuesoldValues` коллекциях.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Выполняет асинхронную операцию вставки в списке данных, которые DataSourceView представляет объект. (Унаследовано от DataSourceView)
Insert(IDictionary)	Выполняет операцию вставки, вызвав метод бизнес-объекта, который определяется InsertMethod свойством с помощью указанной `values` коллекции.
LoadViewState(Object)	Восстанавливает ранее сохраненное состояние представления для представления источника данных.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnDataSourceViewChanged(EventArgs)	Вызывает событие DataSourceViewChanged. (Унаследовано от DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Deleted Вызывает событие после ObjectDataSourceView завершения операции удаления объекта.
OnDeleting(ObjectDataSourceMethodEventArgs)	Deleting Вызывает событие перед ObjectDataSourceView попыткой операции удаления объекта.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Filtering Вызывает событие перед ObjectDataSourceView попыткой операции фильтрации объекта.
OnInserted(ObjectDataSourceStatusEventArgs)	Inserted Вызывает событие после ObjectDataSourceView завершения операции вставки объекта.
OnInserting(ObjectDataSourceMethodEventArgs)	Inserting Вызывает событие перед ObjectDataSourceView попыткой операции вставки объекта.
OnObjectCreated(ObjectDataSourceEventArgs)	ObjectCreated Вызывает событие после ObjectDataSourceView создания экземпляра объекта, определяемого свойствомTypeName.
OnObjectCreating(ObjectDataSourceEventArgs)	ObjectCreating Вызывает событие перед ObjectDataSourceView созданием экземпляра бизнес-объекта для выполнения операции данных.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	ObjectDisposing Вызывает событие перед ObjectDataSourceView удалением экземпляра объекта.
OnSelected(ObjectDataSourceStatusEventArgs)	Selected Вызывает событие после ObjectDataSourceView завершения операции извлечения данных.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Selecting Вызывает событие перед ObjectDataSourceView попыткой операции извлечения данных.
OnUpdated(ObjectDataSourceStatusEventArgs)	Updated Вызывает событие после ObjectDataSourceView завершения операции обновления объекта.
OnUpdating(ObjectDataSourceMethodEventArgs)	Updating Вызывает событие перед ObjectDataSourceView попыткой операции обновления объекта.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Вызывается методом RaiseUnsupportedCapabilitiesError(DataSourceView) для сравнения возможностей, запрошенных для ExecuteSelect(DataSourceSelectArguments) операции, с теми, которые поддерживает представление. (Унаследовано от DataSourceView)
SaveViewState()	Сохраняет изменения состояния представления для ObjectDataSourceView объекта с момента размещения страницы на сервере.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Возвращает список данных асинхронно из базового хранилища данных. (Унаследовано от DataSourceView)
Select(DataSourceSelectArguments)	Извлекает данные из объекта, определяемого TypeName свойством, путем вызова метода, определяемого SelectMethod свойством, и передачи любых значений SelectParameters в коллекции.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Вызывает ObjectDataSourceView отслеживание изменений в состоянии представления, чтобы изменения могли храниться в объекте ViewState для элемента управления и сохраняться между запросами на одну и ту же страницу.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет асинхронную операцию обновления в списке данных, которые DataSourceView представляет объект. (Унаследовано от DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Выполняет операцию обновления путем вызова метода, определяемого свойствомUpdateMethod, и используя все параметры, предоставленные в `keys`коллекциях или `valuesoldValues` коллекциях.

События

Имя	Описание
DataSourceViewChanged	Происходит при изменении представления источника данных. (Унаследовано от DataSourceView)
Deleted	Происходит при Delete завершении операции.
Deleting	Происходит перед операцией Delete .
Filtering	Происходит перед операцией фильтра.
Inserted	Происходит при Insert завершении операции.
Inserting	Происходит перед операцией Insert .
ObjectCreated	Происходит после ObjectDataSourceView создания экземпляра типа, определяемого свойством TypeName .
ObjectCreating	Происходит перед ObjectDataSourceView созданием экземпляра типа, определяемого свойством TypeName .
ObjectDisposing	Происходит при ObjectDataSourceView удалении экземпляра созданного объекта.
Selected	Происходит при завершении операции извлечения данных.
Selecting	Происходит перед операцией извлечения данных.
Updated	Происходит при Update завершении операции.
Updating	Происходит перед операцией Update .

Явные реализации интерфейса

Имя	Описание
IStateManager.IsTrackingViewState	Описание этого элемента см. в разделе IsTrackingViewState.
IStateManager.LoadViewState(Object)	Описание этого элемента см. в разделе LoadViewState(Object).
IStateManager.SaveViewState()	Описание этого элемента см. в разделе SaveViewState().
IStateManager.TrackViewState()	Описание этого элемента см. в разделе TrackViewState().

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

См. также раздел

Кері байланыс

Бет пайдалы болды ма?

Бөлісу құралы: