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 。

適用於