DbContext.SaveChangesAsync 方法

定義

命名空間:

System.Data.Entity

組件:

EntityFramework.dll

多載

名稱	Description
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

在嘗試在上下文中處理實體時，無論是在向資料庫發送指令之前或之後，都會發生某些錯誤。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。

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

A CancellationToken 在等待任務完成時觀察。

傳回

Task<Int32>

代表非同步儲存操作的任務。 任務結果包含寫入底層資料庫的狀態條目數量。 這可以包含實體和/或關係的狀態條目。 關係狀態條目用於多對多關係及實體類別中不包含外鍵屬性的關係（通常稱為獨立關聯）。

屬性

SuppressMessageAttribute

例外狀況

InvalidOperationException

如果背景已經被處理掉，我會丟掉。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。