DbSet<TEntity>.FindAsync 方法

  • 参考

定义

命名空间:
Microsoft.EntityFrameworkCore
程序集:
Microsoft.EntityFrameworkCore.dll
包:
Microsoft.EntityFrameworkCore v1.1.6
包:
Microsoft.EntityFrameworkCore v2.0.3
包:
Microsoft.EntityFrameworkCore v2.1.11
包:
Microsoft.EntityFrameworkCore v2.2.6
包:
Microsoft.EntityFrameworkCore v3.0.0
包:
Microsoft.EntityFrameworkCore v3.1.0
包:
Microsoft.EntityFrameworkCore v5.0.0
包:
Microsoft.EntityFrameworkCore v6.0.0
包:
Microsoft.EntityFrameworkCore v7.0.0
包:
Microsoft.EntityFrameworkCore v8.0.0

重载

FindAsync(Object[])

查找带给定主键值的实体。 如果上下文正在跟踪具有给定主键值的实体，则会立即返回该实体，而无需向数据库发出请求。 否则，对数据库查询具有给定主键值的实体，如果找到此实体，则会附加到上下文并返回。 如果未找到实体，则返回 null。
FindAsync(Object[], CancellationToken)

查找带给定主键值的实体。 如果上下文正在跟踪具有给定主键值的实体，则会立即返回该实体，而无需向数据库发出请求。 否则，对数据库查询具有给定主键值的实体，如果找到此实体，则会附加到上下文并返回。 如果未找到实体，则返回 null。

FindAsync(Object[])

查找带给定主键值的实体。 如果上下文正在跟踪具有给定主键值的实体，则会立即返回该实体，而无需向数据库发出请求。 否则，对数据库查询具有给定主键值的实体，如果找到此实体，则会附加到上下文并返回。 如果未找到实体，则返回 null。

public virtual System.Threading.Tasks.Task<TEntity> FindAsync (params object[] keyValues);
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync (params object[] keyValues);
public virtual System.Threading.Tasks.ValueTask<TEntity?> FindAsync (params object?[]? keyValues);
abstract member FindAsync : obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
override this.FindAsync : obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
abstract member FindAsync : obj[] -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
override this.FindAsync : obj[] -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
Public Overridable Function FindAsync (ParamArray keyValues As Object()) As Task(Of TEntity)
Public Overridable Function FindAsync (ParamArray keyValues As Object()) As ValueTask(Of TEntity)

参数

keyValues
Object[]

要查找的实体的主键值。

返回

Task<TEntity>
ValueTask<TEntity>

找到的实体，或 null。

注解

有关详细信息和示例，请参阅 使用 Find 和 FindAsync 。

适用于

FindAsync(Object[], CancellationToken)

查找带给定主键值的实体。 如果上下文正在跟踪具有给定主键值的实体，则会立即返回该实体，而无需向数据库发出请求。 否则，对数据库查询具有给定主键值的实体，如果找到此实体，则会附加到上下文并返回。 如果未找到实体，则返回 null。

public virtual System.Threading.Tasks.Task<TEntity> FindAsync (object[] keyValues, System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync (object[] keyValues, System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<TEntity?> FindAsync (object?[]? keyValues, System.Threading.CancellationToken cancellationToken);
abstract member FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
override this.FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
abstract member FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
override this.FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
Public Overridable Function FindAsync (keyValues As Object(), cancellationToken As CancellationToken) As Task(Of TEntity)
Public Overridable Function FindAsync (keyValues As Object(), cancellationToken As CancellationToken) As ValueTask(Of TEntity)

参数

keyValues
Object[]

要查找的实体的主键值。

cancellationToken
CancellationToken

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

返回

Task<TEntity>
ValueTask<TEntity>

找到的实体，或 null。

例外

OperationCanceledException

如果已取消 CancellationToken。

注解

有关详细信息和示例，请参阅 使用 Find 和 FindAsync 。

适用于