Delete 方法 （ADO 記錄集）

刪除目前記錄或記錄群組。

語法

  
recordset.Delete AffectRecords  

參數

AffectRecords
AffectEnum 值，決定 Delete 方法會影響多少筆記錄。 預設值為 adAffectCurrent。

注意

adAffectAll 和 adAffectAllChapters 不是 Delete的有效自變數。

言論

使用 Delete 方法會將當前記錄或 Recordset 物件中的記錄群組標示為要刪除。 如果 Recordset 物件不允許刪除記錄，就會發生錯誤。 如果您處於立即更新模式，則會立即在資料庫中進行刪除。 如果無法成功刪除記錄（例如，由於資料庫完整性違規），記錄會在呼叫 Update之後保持編輯模式。 這表示您必須取消 CancelUpdate 的更新，然後才能離開當前記錄（例如，使用 Close、Move或 NextRecordset）。

如果您處於批次更新模式，記錄會標示為要從快取刪除，而且當您呼叫 UpdateBatch 方法時，就會進行實際刪除。 使用 Filter 屬性來檢視已刪除的記錄。

從已刪除的記錄擷取域值會產生錯誤。 刪除目前記錄之後，已刪除的記錄會維持目前狀態，直到您移至不同的記錄為止。 一旦您離開已刪除的記錄，就無法再存取它。

如果您在交易中巢狀刪除，您可以使用 rollbackTrans 方法 復原已刪除的記錄。 如果您處於批次更新模式，您可以使用 CancelBatch 方法來取消擱置刪除或擱置刪除群組。

如果嘗試刪除記錄失敗，因為與基礎數據發生衝突（例如，另一位使用者已經刪除記錄），提供者會將警告傳回給 Errors 集合，但不會停止程序執行。 只有在所有要求的記錄發生衝突時，才會發生運行時錯誤。

如果已設定 Unique Table 動態屬性，且 Recordset 是對多個數據表執行 JOIN 作業的結果，則 Delete 方法只會從 Unique Table 屬性中名為 的數據表中刪除數據列。

適用於

Recordset 物件 （ADO）

另請參閱

Delete 方法範例 （VB）
Delete 方法範例 （VBScript）
Delete 方法範例 （VC++）
Delete 方法 （ADO Fields 集合）
Delete 方法 （ADO Parameters 集合）
DeleteRecord 方法 （ADO）