RowUpdating
Событие RowUpdating генерируется перед обновлением любой строки из DataSet в источнике данных, поэтому с его помощью можно изменить поведение обновления до того, как оно начнется, чтобы обеспечить, например:
-
дополнительную обработку при обновлении;
-
сохранить ссылку на обновленную строку;
-
отменить текущее обновление;
-
запланировать текущее обновление для пакетной обработки впоследствии и т. д.
Синтаксис
public class RowUpdatingEventArgs:EventArgs;
Свойства аргумента RowUpdatingEventArgs (значения EventArgs):
-
Command
– ссылка на объектCommand
, применяемый для выполнения обновлений; -
Errors
– получать ошибки, выявляемые ADO.NET-провайдером при выполнении свойства Command; -
Row
– ссылка на объектDataRow
, содержащий обновленные сведения; -
StatementType
– тип выполняемого обновления (SELECT, INSERT, UPDATE, DELETE); -
TableMappings
– описание сопоставленных отношений между исходной таблицей и объектомDataTable
(элемент коллекции DbDataAdapter.TableMappings); -
Status
– реакция на ошибку:
-
Continue
– продолжить операцию обновления; -
ErrorsOccurred
– прервать операцию обновления и сгенерировать исключение; -
SkipCurrentRow
– пропустить текущую строку и продолжить операцию обновления; -
SkipAllRemainingRows
– прервать операцию обновления без генерации исключения.
При возникновении события свойство Status совпадает с Continue или ErrorsOccurred.
Назначение свойству Status значения ErrorsOccurred приведет к генерации исключения.
При использовании других значений Status исключение не вызывается.
Генерацию нужного исключения можно задать с помощью свойства Errors.
Пример
См. пример в подпункте «RowUpdated».