Обработка событий DataTable (ado.Net)
Объект DataTableпредоставляет ряд событий, которые может обрабатывать приложение. В следующей таблице приводится описание событий DataTable.
|
Событие |
Описание |
|
Initialized |
Происходит после вызова метода EndInitобъекта DataTable. Главным образом это событие предназначено для поддержки сценариев во время разработки. |
|
ColumnChanged |
Происходит после успешного изменения значения в объекте DataColumn. |
|
ColumnChanging |
Происходит при подаче значения для объекта DataColumn. |
|
RowChanged |
Происходит после успешного изменения значения DataColumn или состояния RowStateобъектаDataRowв объекте DataTable. |
|
RowChanging |
Происходит при подаче изменения для значения DataColumn или состояния RowState объекта DataRow в объекте DataTable. |
|
RowDeleted |
Происходит после того, как объект DataRow в объекте DataTable был отмечен, как Deleted. |
|
RowDeleting |
Происходит перед тем, как объект DataRow в объекте DataTable будет отмечен как Deleted. |
|
TableCleared |
Происходит после того, как вызов метода Clearобъекта DataTable успешно очистил каждый объект DataRow. |
|
TableClearing |
Происходит после вызова метода Clear, но до начала операции Clear. |
|
TableNewRow |
Происходит после создания нового объекта DataRow путем вызова метода NewRow объекта DataTable. |
|
Disposed |
Происходит, когда объект DataTable удаляется Disposed. Наследуется от MarshalByValueComponent. |
|
| |
|
Большинство операций, которые добавляют или удаляют строки, не вызывают событий ColumnChanged и ColumnChanging. Однако метод ReadXml вызывает события ColumnChanged и ColumnChanging, если только свойству XmlReadMode не задано значение DiffGram или значение Auto, когда читаемый XML-документ является DiffGram. | |
Примечание.
|
|
|
Изменение данных в объекте DataSet, из которого было вызвано событие RowChanged, может привести к повреждению данных. При подобном повреждении данных исключение вызвано не будет. |
Внимание!Дополнительные связанные события
Свойство Constraintsсодержит экземпляр ConstraintCollection. КлассConstraintCollectionпредставляет событиеCollectionChanged. Это событие возникает при добавлении, изменении или удалении ограничения из коллекции ConstraintCollection.
Свойство Columnsсодержит ссылку на экземплярDataColumnCollection. Класс DataColumnCollection содержит событиеCollectionChanged. Это событие возникает при добавлении, изменении или удалении из коллекции DataColumnCollection объекта DataColumn. Среди изменений, которые могут вызвать возникновение этого события, — изменения имени, типа, выражения или порядкового номера столбца.
Свойство TablesобъектаDataSetсодержит ссылку на экземплярDataTableCollection. Класс DataTableCollection вызывает события CollectionChanged и CollectionChanging. Эти события возникают при добавлении или удалении из коллекции DataTable объекта DataTable.
Внесение изменений в объекты DataRows также могут вызвать события для ассоциированного объекта DataView. Класс DataView вызывает событиеListChanged, которое возникает при изменении значения DataColumn или при изменении композиции или порядка сортировки представления. КлассDataRowViewвызывает событиеPropertyChanged, которое возникает при изменении значения ассоциированного объекта DataColumn.