DbSet.FindAsync 方法

定義

命名空間:

System.Data.Entity

組件:

EntityFramework.dll

多載

FindAsync(Object[])	以非同步方式尋找具有指定主鍵值的實體。 如果具有給定主索引鍵值的實體存在於內容中，則會立刻傳回此實體，而不會對存放區發出要求。 同樣地，如果是具有給定主索引鍵值的實體，則會對存放區發出要求，而且如果找到這個實體，則會將它附加至內容中並傳回。 如果內容或存放區中找不到任何實體，則會傳回 null。
FindAsync(CancellationToken, Object[])	以非同步方式尋找具有指定主鍵值的實體。 如果具有給定主索引鍵值的實體存在於內容中，則會立刻傳回此實體，而不會對存放區發出要求。 同樣地，如果是具有給定主索引鍵值的實體，則會對存放區發出要求，而且如果找到這個實體，則會將它附加至內容中並傳回。 如果內容或存放區中找不到任何實體，則會傳回 null。

FindAsync(Object[])

以非同步方式尋找具有指定主鍵值的實體。 如果具有給定主索引鍵值的實體存在於內容中，則會立刻傳回此實體，而不會對存放區發出要求。 同樣地，如果是具有給定主索引鍵值的實體，則會對存放區發出要求，而且如果找到這個實體，則會將它附加至內容中並傳回。 如果內容或存放區中找不到任何實體，則會傳回 null。

public virtual System.Threading.Tasks.Task<object> FindAsync (params object[] keyValues);

abstract member FindAsync : obj[] -> System.Threading.Tasks.Task<obj>
override this.FindAsync : obj[] -> System.Threading.Tasks.Task<obj>

Public Overridable Function FindAsync (ParamArray keyValues As Object()) As Task(Of Object)

參數

keyValues

Object[]

要尋找之實體的主索引鍵值。

傳回

Task<Object>

表示非同步尋找作業的工作。 工作結果包含找到的實體或 Null。

例外狀況

InvalidOperationException

如果已處置內容，則會擲回 。

備註

複合索引鍵值的順序如 EDM 中所定義，依設計工具、Code First Fluent API 或 DataMember 屬性所定義。 不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。

FindAsync(CancellationToken, Object[])

以非同步方式尋找具有指定主鍵值的實體。 如果具有給定主索引鍵值的實體存在於內容中，則會立刻傳回此實體，而不會對存放區發出要求。 同樣地，如果是具有給定主索引鍵值的實體，則會對存放區發出要求，而且如果找到這個實體，則會將它附加至內容中並傳回。 如果內容或存放區中找不到任何實體，則會傳回 null。

public virtual System.Threading.Tasks.Task<object> FindAsync (System.Threading.CancellationToken cancellationToken, params object[] keyValues);

abstract member FindAsync : System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<obj>
override this.FindAsync : System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<obj>

參數

cancellationToken

CancellationToken

CancellationToken等候工作完成時要觀察的 。

keyValues

Object[]

要尋找之實體的主索引鍵值。

傳回

Task<Object>

表示非同步尋找作業的工作。 工作結果包含找到的實體或 Null。

例外狀況

InvalidOperationException

如果已處置內容，則會擲回 。

備註

複合索引鍵值的順序如 EDM 中所定義，依設計工具、Code First Fluent API 或 DataMember 屬性所定義。 不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。