ChangeTracker.Clear 方法

定義

命名空間:

Microsoft.EntityFrameworkCore.ChangeTracking

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v8.0.0

停止追蹤所有目前追蹤的實體。

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

備註

DbContext 的設計目的是要有簡短的存留期，其中會為每個工作單位建立新的實例。 這種方式表示當內容在每個工作單位結束時處置內容時，會捨棄所有追蹤的實體。 不過，使用此方法清除所有追蹤的實體，在建立新的內容實例並不實用的情況下可能很有用。

這個方法應該一律優先于卸離每個追蹤的實體。 卸離實體是可能會有副作用的緩慢程式。 此方法在清除內容中的所有追蹤實體時更有效率。

請注意，此方法不會產生 StateChanged 事件，因為實體不會個別中斷連結。

如需詳細資訊和範例，請參閱 EF Core 變更追蹤 。