DbContext.SaveChangesAsync 方法

定義

命名空間:

System.Data.Entity

組件:

EntityFramework.dll

多載

SaveChangesAsync()	以非同步方式將此內容中所做的所有變更儲存至基礎資料庫。
SaveChangesAsync(CancellationToken)	以非同步方式將此內容中所做的所有變更儲存至基礎資料庫。

SaveChangesAsync()

以非同步方式將此內容中所做的所有變更儲存至基礎資料庫。

public virtual System.Threading.Tasks.Task<int> SaveChangesAsync ();

abstract member SaveChangesAsync : unit -> System.Threading.Tasks.Task<int>
override this.SaveChangesAsync : unit -> System.Threading.Tasks.Task<int>

Public Overridable Function SaveChangesAsync () As Task(Of Integer)

傳回

Task<Int32>

代表非同步儲存作業的工作。 工作結果包含寫入基礎資料庫的狀態專案數目。 這可以包含實體和/或關聯性的狀態專案。 關聯性狀態專案是針對多對多關聯性和關聯性所建立，其中實體類別中未包含任何外鍵屬性 (通常稱為獨立關聯) 。

例外狀況

DbUpdateException

傳送更新至資料庫時發生錯誤。

DbUpdateConcurrencyException

資料庫命令不會影響預期的資料列數目。 這通常表示開放式平行存取違規;也就是說，自從查詢資料列之後，資料庫中的資料列已經變更。

DbEntityValidationException

儲存已中止，因為實體屬性值驗證失敗。

NotSupportedException

嘗試使用不支援的行為，例如在相同的內容實例上同時執行多個非同步命令。

ObjectDisposedException

內容或連接已處置。

InvalidOperationException

嘗試在將命令傳送至資料庫之前或之後，嘗試處理內容中的實體時發生一些錯誤。

備註

不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。

SaveChangesAsync(CancellationToken)

以非同步方式將此內容中所做的所有變更儲存至基礎資料庫。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Usage", "CA1801:ReviewUnusedParameters", MessageId="cancellationToken")]
public virtual System.Threading.Tasks.Task<int> SaveChangesAsync (System.Threading.CancellationToken cancellationToken);

abstract member SaveChangesAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.SaveChangesAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

參數

cancellationToken

CancellationToken

CancellationToken等候工作完成時要觀察的 。

傳回

Task<Int32>

代表非同步儲存作業的工作。 工作結果包含寫入基礎資料庫的狀態專案數目。 這可以包含實體和/或關聯性的狀態專案。 關聯性狀態專案是針對多對多關聯性和關聯性所建立，其中實體類別中未包含任何外鍵屬性 (通常稱為獨立關聯) 。

屬性

SuppressMessageAttribute

例外狀況

InvalidOperationException

如果已處置內容，則會擲回 。

備註

不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。