Data.Win.ADODB.TCustomADODataSet.DeleteRecords
Delphi
procedure DeleteRecords(AffectRecords: TAffectRecords = arAll);
C++
void __fastcall DeleteRecords(TAffectRecords AffectRecords = (TAffectRecords)(0x2));
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TCustomADODataSet |
Description
Supprime un ou plusieurs enregistrements de l'ensemble de données.
Appelez DeleteRecords pour supprimer un ou plusieurs enregistrements dans l'ensemble d'enregistrements que représente le composant ensemble de données ADO.
Si l'ensemble d'enregistrements ne gère pas les suppressions, une exception est déclenchée. Utilisez la méthode Supports pour déterminer si l'ensemble d'enregistrements gère la suppression d'enregistrement.
Si l'ensemble de données a été ouvert en mode mise à jour groupée, les enregistrements sont seulement marqués pour effacement. Appliquez les suppressions groupées en appelant la méthode UpdateBatch. Si l'ensemble de données n'est pas en mode mise à jour groupée, les enregistrements sont immédiatement supprimés dans la table de la base.
AffectRecords est une constante TAffectRecords qui détermine les enregistrements supprimés par DeleteRecords. La valeur par défaut du paramètre AffectRecords est arAll, ce qui provoque la suppression de tous les enregistrements de l'ensemble d'enregistrements.
Option | Signification |
---|---|
arCurrent |
Supprime uniquement l'enregistrement en cours. |
arFiltered |
Supprime uniquement les enregistrements accessibles via le filtre en cours. |
arAll |
Supprime tous les enregistrements de l'ensemble d'enregistrements. |
arAllChapters |
Supprime les enregistrements de tous les chapitres (il s'agit des chapitres ADO) |