Data.Win.ADODB.TCustomADODataSet.OnWillChangeRecordset
Delphi
property OnWillChangeRecordset: TRecordsetReasonEvent read FOnWillChangeRecordset write FOnWillChangeRecordset;
C++
__property TRecordsetReasonEvent OnWillChangeRecordset = {read=FOnWillChangeRecordset, write=FOnWillChangeRecordset};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| event | published | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TCustomADODataSet |
Description
Se produit avant la modification de l'ensemble d'enregistrements.
Ecrivez un gestionnaire d'événement OnWillChangeRecordset pour effectuer des actions spécifiques avant que l'objet Recordset du composant ensemble de données ne soit modifié.
DataSet est le composant ensemble de données ADO qui a déclenché l'événement OnWillChangeRecordset. Ce composant ensemble de données contient également l'ensemble d'enregistrements en question.
Reason indique le type de changement qui a déclenché l'événement. Même si le type TEventReason contient davantage de constantes, la valeur de Reason pour un événement OnWillChangeRecordset est limité à : erAddNew, erDelete, erUpdate, erUndoUpdate, erUndoAddNew, erUndoDelete et erFirstChange.
La valeur EventStatus (EventStatusEnum ADO) indique le succès ou l'échec de l'exécution de l'opération qui a déclenché cet événement. EventStatus a la valeur esOK si l'opération qui a déclenché l'événement s'est exécutée sans erreur, esErrorsOccured si une erreur s'est produite durant l'exécution de cette opération ou esCancel si l'opération a été annulée.
Remarque : : L'événement OnWillChangeRecordset est purement un événement de l'objet Recordset qui est indépendant de tous les événements de changement de données VCL.