DbSet<TEntity>.FindAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 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 。
例外狀況
備註
如需詳細資訊和範例，請參閱 使用 Find 和 FindAsync 。
