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 , передают свои параметры в IOrderedDictionary интерфейсе ObjectDataSourceView в , а объект представления объединяет эти параметры с любыми параметрами, которые находятся в UpdateParameters коллекции.

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

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

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

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

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

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

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

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

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

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

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

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

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

класс ObjectDataSourceView реализует IStateManager интерфейс и использует состояние представления для отслеживания его состояния в запросах страниц. 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)	Выполняет операцию удаления путем вызова метода бизнес-объектов, заданного свойством DeleteMethod, используя заданные коллекции `keys` и `oldValues`.
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет операцию асинхронного удаления в списке данных, представляющем объект DataSourceView. (Унаследовано от DataSourceView)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ExecuteCommand(String, IDictionary, IDictionary)	Выполняет указанную команду. (Унаследовано от DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет указанную команду. (Унаследовано от DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Выполняет операцию удаления, используя метод DeleteMethod и заданные коллекции `keys` и `oldValues`.
ExecuteInsert(IDictionary)	Выполняет операцию вставки путем вызова метода бизнес-объектов, заданного свойством InsertMethod, используя заданную коллекцию `values`.
ExecuteSelect(DataSourceSelectArguments)	Извлекает данные из объекта, заданного свойством TypeName, вызвав метод, указанный в свойстве SelectMethod, и передав значения в коллекцию SelectParameters.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Выполняет операцию обновления путем вызова метода, заданного свойством UpdateMethod, используя при этом все параметры, предоставленные в коллекциях `keys`, `values` или `oldValues`.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
Insert(IDictionary)	Выполняет операцию вставки путем вызова метода бизнес-объектов, заданного свойством InsertMethod, используя заданную коллекцию `values`.
Insert(IDictionary, DataSourceViewOperationCallback)	Выполняет операцию асинхронной вставки по списку данных, представляющем объект DataSourceView. (Унаследовано от DataSourceView)
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)	Извлекает данные из объекта, заданного свойством TypeName, вызвав метод, указанный в свойстве SelectMethod, и передав значения в коллекцию SelectParameters.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Асинхронно возвращает список данных из хранилища базовых данных. (Унаследовано от DataSourceView)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Инициирует отслеживание элементом управления ObjectDataSourceView изменений в состоянии его представления, благодаря чему эти изменения можно сохранить для этого элемента в объекте ViewState и хранить их для всех запросов одной и той же страницы.
Update(IDictionary, IDictionary, IDictionary)	Выполняет операцию обновления путем вызова метода, заданного свойством UpdateMethod, используя при этом все параметры, предоставленные в коллекциях `keys`, `values` или `oldValues`.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет операцию асинхронного обновления в списке данных, представляющем объект DataSourceView. (Унаследовано от DataSourceView)

События

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().

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