Поделиться через


ObjectDataSourceView Класс

Определение

Поддерживает элемент управления 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
Наследование
ObjectDataSourceView
Реализации

Комментарии

Класс ObjectDataSourceView предназначен в основном для использования элементами управления с привязкой к данным, а не как программируемый объект в коде страницы.

Класс 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. Например, DeleteMethodObjectDataSourceView свойство объекта задается путем задания DeleteMethod свойства объекта ObjectDataSource.

Извлечение данных

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

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

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

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

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

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

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

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

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

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

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

Вы можете отсортировать данные, полученные с помощью , ObjectDataSource упорядочив данные в памяти после их извлечения. Сортировка поддерживается только элементом управления, ObjectDataSourceSelect если метод возвращает 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, 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, values или oldValues.

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, values или oldValues.

События

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

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

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