DbSet.FindAsync 方法 (Object[])

發行項
01/12/2015

[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊，請參閱 msdn.com/data/ef。]

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

命名空間： System.Data.Entity
組件： EntityFramework (在 EntityFramework.dll 中)

語法

'宣告
Public Overridable Function FindAsync ( _
    ParamArray keyValues As Object() _
) As Task(Of Object)
'用途
Dim instance As DbSet 
Dim keyValues As Object()
Dim returnValue As Task(Of Object)

returnValue = instance.FindAsync(keyValues)

public virtual Task<Object> FindAsync(
    params Object[] keyValues
)

public:
virtual Task<Object^>^ FindAsync(
    ... array<Object^>^ keyValues
)

abstract FindAsync : 
        keyValues:Object[] -> Task<Object> 
override FindAsync : 
        keyValues:Object[] -> Task<Object>

public function FindAsync(
    ... keyValues : Object[]
) : Task<Object>

參數

keyValues
類型：System.Object[]
要尋找之實體的主索引鍵值。

傳回值

類型：System.Threading.Tasks.Task<Object>
表示非同步尋找作業的工作。工作結果包含找到的實體，或 null。

例外狀況

例外狀況	條件
InvalidOperationException	如果內容中存在多個具有給定主索引鍵值的實體，就會擲回。
InvalidOperationException	如果實體的類型不是此內容的資料模型的一部分，就會擲回。
InvalidOperationException	如果索引鍵值的類型不符合要找到之實體類型的索引鍵值類型，就會擲回。
InvalidOperationException	當內容已經過處置時擲回。