DbSet<TEntity>.FindAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| FindAsync(CancellationToken, Object[]) |
非同步尋找具有給定主鍵值的實體。 如果上下文中存在具有給定主鍵值的實體,則該實體會立即回傳,無需向儲存庫提出請求。 否則,會向儲存裝置請求具有指定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若上下文或儲存中未找到實體,則回傳 null。 |
| FindAsync(Object[]) |
非同步尋找具有給定主鍵值的實體。 如果上下文中存在具有給定主鍵值的實體,則該實體會立即回傳,無需向儲存庫提出請求。 否則,會向儲存裝置請求具有指定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若上下文或儲存中未找到實體,則回傳 null。 |
FindAsync(CancellationToken, Object[])
非同步尋找具有給定主鍵值的實體。 如果上下文中存在具有給定主鍵值的實體,則該實體會立即回傳,無需向儲存庫提出請求。 否則,會向儲存裝置請求具有指定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若上下文或儲存中未找到實體,則回傳 null。
public virtual System.Threading.Tasks.Task<TEntity> FindAsync(System.Threading.CancellationToken cancellationToken, params object[] keyValues);
abstract member FindAsync : System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
override this.FindAsync : System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
參數
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
- keyValues
- Object[]
要找到實體的主鍵值。
傳回
一個代表非同步查找操作的任務。 任務結果包含找到的實體,也就是 null。
例外狀況
如果背景已經被處理掉,我會丟掉。
備註
複合鍵值的排序依據 EDM 定義,而 EDM 又依設計器、Code First 流暢 API 或 DataMember 屬性定義。 不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。
適用於
FindAsync(Object[])
非同步尋找具有給定主鍵值的實體。 如果上下文中存在具有給定主鍵值的實體,則該實體會立即回傳,無需向儲存庫提出請求。 否則,會向儲存裝置請求具有指定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若上下文或儲存中未找到實體,則回傳 null。
public virtual System.Threading.Tasks.Task<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)>
Public Overridable Function FindAsync (ParamArray keyValues As Object()) As Task(Of TEntity)
參數
- keyValues
- Object[]
要找到實體的主鍵值。
傳回
一個代表非同步查找操作的任務。 任務結果包含找到的實體,也就是 null。
備註
複合鍵值的排序依據 EDM 定義,而 EDM 又依設計器、Code First 流暢 API 或 DataMember 屬性定義。 不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。