События EntityDataSource
Обновлен: Ноябрь 2007
События элемента управления EntityDataSource позволяют расширить функциональные возможности приложений ASP.NET, не ограничиваясь действиями по изменению разметки. Обработчики событий позволяют проверять данные, устанавливать значения свойств, которые не привязаны к данным, получать информацию о результатах запросов и управлять жизненным циклом объекта ObjectContext, используемого для формирования запросов и обновления данных.
Описание событий элементов управления источниками данных см в разделе События, связанные с возможностями элементов управления данными ASP.NET по вставке, обновлению и удалению.
Событие |
Описание |
|---|---|
Событие ContextCreating передает экземпляр ObjectContext, который должен использоваться элементом управления EntityDataSource в последующих операциях. Дополнительные сведения см. в разделе Управление жизненным циклом контекста объекта. |
|
Событие ContextCreated позволяет получить доступ к экземпляру ObjectContext, созданному элементом управления EntityDataSource. Этот объект контекста может храниться и использоваться для последующих операций вне EntityDataSource. Дополнительные сведения см. в разделе Управление жизненным циклом контекста объекта. |
|
Событие ContextDisposing позволяет предотвратить удаление объекта ObjectContext, используемого элементом управления EntityDataSource. Его следует обрабатывать, когда на странице требуется использовать один экземпляр ObjectContext для нескольких элементов управления или экземпляров элемента управления EntityDataSource. |
|
Событие Selecting позволяет изменить конфигурацию EntityDataSource и прочитать или изменить аргументы из элемента управления с привязкой к данным перед составлением и выполнением запроса. Его следует обрабатывать, если требуется изменить разбиение по страницам или сортировку для элемента управления либо отменить запрос. |
|
Событие Selected позволяет получить доступ к результатам запроса и извлечь информацию о количестве строк. Его следует обрабатывать, если требуется получить доступ к объектам, являющимся результатом запроса, или сохранить объекты в состоянии представления. |
|
Событие Inserting позволяет изменить или проверить добавляемый объект, добавить другой объект или отменить операцию. Его следует обрабатывать, чтобы получить доступ к объекту, добавляемому с использованием свойства Entity объекта EntityDataSourceChangingEventArgs. |
|
Событие Inserted позволяет получить доступ к объекту, созданному в источнике данных. Свойство Entity объекта EntityDataSourceChangedEventArgs используется для доступа к добавленному объекту. |
|
Событие Updating позволяет проверить или откорректировать внесенные в объект изменения, предоставить другой объект или отменить операцию до сохранения изменений. Доступ к измененному объекту возможен с использованием свойства Entity объекта EntityDataSourceChangingEventArgs. Обработка этого события целесообразна, когда требуется проверить или откорректировать изменения или изменить объект ObjectStateEntry для данного объекта, задав другие исходные значения для управления параллелизмом. Дополнительные сведения см. в разделе Сохранение изменений и управление параллелизмом (Entity Framework). |
|
Событие Updated позволяет получить доступ к объекту, изменения которого были только что сохранены в источнике данных. Свойство Entity объекта EntityDataSourceChangedEventArgs используется для доступа к обновленному объекту. |
|
Событие Deleting позволяет получить доступ к объекту перед его удалением из источника данных или отменить операцию. СвойствоEntity объекта EntityDataSourceChangingEventArgs используется для доступа к удаляемому объекту. |
|
Событие Deleted позволяет получить доступ к объекту, удаленному из источника данных. Свойство Entity объекта EntityDataSourceChangingEventArgs используется для доступа к удаленному объекту. Возвращаемый объект находится в состоянии Detached. |
|
Exception() |
Событие IDynamicDataSource.Exception реализовано для совместимости с платформой динамических данных ASP.NET. Обработчик этого события нельзя зарегистрировать в разметке. Он может использоваться только тогда, когда экземпляр EntityDataSource приведен к интерфейсу IDynamicDataSource. Дополнительные сведения см. в разделе Общие сведения о модели динамических данных ASP.NET. |
См. также
Основные понятия
Управление жизненным циклом контекста объекта (EntityDataSource)
Настройка элемента управления EntityDataSource
Обновление данных (EntityDataSource)