События EntityDataSource

Visual Studio 2010

Обновлен: Ноябрь 2007

События элемента управления EntityDataSource позволяют расширить функциональные возможности приложений ASP.NET, не ограничиваясь действиями по изменению разметки. Обработчики событий позволяют проверять данные, устанавливать значения свойств, которые не привязаны к данным, получать информацию о результатах запросов и управлять жизненным циклом объекта ObjectContext, используемого для формирования запросов и обновления данных.

Описание событий элементов управления источниками данных см в разделе События, связанные с возможностями элементов управления данными ASP.NET по вставке, обновлению и удалению.

Событие

Описание

ContextCreating

Событие ContextCreating передает экземпляр ObjectContext, который должен использоваться элементом управления EntityDataSource в последующих операциях. Дополнительные сведения см. в разделе Управление жизненным циклом контекста объекта.

ContextCreated

Событие ContextCreated позволяет получить доступ к экземпляру ObjectContext, созданному элементом управления EntityDataSource. Этот объект контекста может храниться и использоваться для последующих операций вне EntityDataSource. Дополнительные сведения см. в разделе Управление жизненным циклом контекста объекта.

ContextDisposing

Событие ContextDisposing позволяет предотвратить удаление объекта ObjectContext, используемого элементом управления EntityDataSource. Его следует обрабатывать, когда на странице требуется использовать один экземпляр ObjectContext для нескольких элементов управления или экземпляров элемента управления EntityDataSource.

Selecting

Событие Selecting позволяет изменить конфигурацию EntityDataSource и прочитать или изменить аргументы из элемента управления с привязкой к данным перед составлением и выполнением запроса. Его следует обрабатывать, если требуется изменить разбиение по страницам или сортировку для элемента управления либо отменить запрос.

Selected

Событие Selected позволяет получить доступ к результатам запроса и извлечь информацию о количестве строк. Его следует обрабатывать, если требуется получить доступ к объектам, являющимся результатом запроса, или сохранить объекты в состоянии представления.

Inserting

Событие Inserting позволяет изменить или проверить добавляемый объект, добавить другой объект или отменить операцию. Его следует обрабатывать, чтобы получить доступ к объекту, добавляемому с использованием свойства Entity объекта EntityDataSourceChangingEventArgs.

Inserted

Событие Inserted позволяет получить доступ к объекту, созданному в источнике данных. Свойство Entity объекта EntityDataSourceChangedEventArgs используется для доступа к добавленному объекту.

Updating

Событие Updating позволяет проверить или откорректировать внесенные в объект изменения, предоставить другой объект или отменить операцию до сохранения изменений. Доступ к измененному объекту возможен с использованием свойства Entity объекта EntityDataSourceChangingEventArgs. Обработка этого события целесообразна, когда требуется проверить или откорректировать изменения или изменить объект ObjectStateEntry для данного объекта, задав другие исходные значения для управления параллелизмом. Дополнительные сведения см. в разделе Сохранение изменений и управление параллелизмом (Entity Framework).

Updated

Событие Updated позволяет получить доступ к объекту, изменения которого были только что сохранены в источнике данных. Свойство Entity объекта EntityDataSourceChangedEventArgs используется для доступа к обновленному объекту.

Deleting

Событие Deleting позволяет получить доступ к объекту перед его удалением из источника данных или отменить операцию. СвойствоEntity объекта EntityDataSourceChangingEventArgs используется для доступа к удаляемому объекту.

Deleted

Событие Deleted позволяет получить доступ к объекту, удаленному из источника данных. Свойство Entity объекта EntityDataSourceChangingEventArgs используется для доступа к удаленному объекту. Возвращаемый объект находится в состоянии Detached.

Exception()

Событие IDynamicDataSource.Exception реализовано для совместимости с платформой динамических данных ASP.NET. Обработчик этого события нельзя зарегистрировать в разметке. Он может использоваться только тогда, когда экземпляр EntityDataSource приведен к интерфейсу IDynamicDataSource. Дополнительные сведения см. в разделе Общие сведения о модели динамических данных ASP.NET.

Показ: