DbContext.SaveChangesAsync 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

包:

Microsoft.EntityFrameworkCore v8.0.0

重载

SaveChangesAsync(Boolean, CancellationToken)	将在此上下文中所做的所有更改保存到数据库。
SaveChangesAsync(CancellationToken)	将在此上下文中所做的所有更改保存到数据库。

SaveChangesAsync(Boolean, CancellationToken)

将在此上下文中所做的所有更改保存到数据库。

public virtual System.Threading.Tasks.Task<int> SaveChangesAsync (bool acceptAllChangesOnSuccess, System.Threading.CancellationToken cancellationToken = default);

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

Public Overridable Function SaveChangesAsync (acceptAllChangesOnSuccess As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

参数

acceptAllChangesOnSuccess

Boolean

指示在更改成功发送到数据库后是否 AcceptAllChanges() 调用 。

cancellationToken

CancellationToken

等待 CancellationToken 任务完成时要观察的 。

返回

Task<Int32>

表示异步保存操作的任务。 任务结果包含写入数据库的状态条目数。

例外

DbUpdateException

保存到数据库时遇到错误。

DbUpdateConcurrencyException

保存到数据库时遇到并发冲突。 如果在保存过程中影响意外的行数，则会发生并发冲突。 这通常是因为数据库中的数据自加载到内存后已修改。

OperationCanceledException

如果已取消 CancellationToken。

注解

此方法将自动调用 DetectChanges() 以发现实体实例的任何更改，然后再保存到基础数据库。 这可以通过 禁用 AutoDetectChangesEnabled。

Entity Framework Core 不支持在同一 DbContext 实例上运行多个并行操作。 这包括异步查询的并行执行以及从多个线程进行的任何显式并发使用。 因此，请始终立即等待异步调用，或者对并行执行的操作使用单独的 DbContext 实例。 有关详细信息和示例 ，请参阅避免 DbContext 线程问题 。

有关详细信息和示例，请参阅 在 EF Core 中保存数据 。

SaveChangesAsync(CancellationToken)

将在此上下文中所做的所有更改保存到数据库。

public virtual System.Threading.Tasks.Task<int> SaveChangesAsync (System.Threading.CancellationToken cancellationToken = default);

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

Public Overridable Function SaveChangesAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

参数

cancellationToken

CancellationToken

等待 CancellationToken 任务完成时要观察的 。

返回

Task<Int32>

表示异步保存操作的任务。 任务结果包含写入数据库的状态条目数。

例外

DbUpdateException

保存到数据库时遇到错误。

DbUpdateConcurrencyException

保存到数据库时遇到并发冲突。 如果在保存过程中影响意外的行数，则会发生并发冲突。 这通常是因为数据库中的数据自加载到内存后已修改。

OperationCanceledException

如果已取消 CancellationToken。

注解

此方法将自动调用 DetectChanges() 以发现实体实例的任何更改，然后再保存到基础数据库。 这可以通过 禁用 AutoDetectChangesEnabled。

Entity Framework Core 不支持在同一 DbContext 实例上运行多个并行操作。 这包括异步查询的并行执行以及从多个线程进行的任何显式并发使用。 因此，请始终立即等待异步调用，或者对并行执行的操作使用单独的 DbContext 实例。 有关详细信息和示例 ，请参阅避免 DbContext 线程问题 。

有关详细信息和示例，请参阅 在 EF Core 中保存数据 。