DbContext.FindAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| FindAsync(Type, Object[], CancellationToken) |
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。 |
| FindAsync(Type, Object[]) |
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。 |
| FindAsync<TEntity>(Object[]) |
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。 |
| FindAsync<TEntity>(Object[], CancellationToken) |
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。 |
FindAsync(Type, Object[], CancellationToken)
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。
public virtual System.Threading.Tasks.Task<object> FindAsync(Type entityType, object[] keyValues, System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<object?> FindAsync(Type entityType, object?[]? keyValues, System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<object> FindAsync(Type entityType, object[] keyValues, System.Threading.CancellationToken cancellationToken);
abstract member FindAsync : Type * obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.FindAsync : Type * obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
abstract member FindAsync : Type * obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
override this.FindAsync : Type * obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Overridable Function FindAsync (entityType As Type, keyValues As Object(), cancellationToken As CancellationToken) As Task(Of Object)
Public Overridable Function FindAsync (entityType As Type, keyValues As Object(), cancellationToken As CancellationToken) As ValueTask(Of Object)
參數
- entityType
- Type
該尋找的實體類型。
- keyValues
- Object[]
要找到實體的主鍵值。
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
找到的實體,或 null。
例外狀況
備註
Entity Framework Core 不支援在同一個 DbContext 實例上執行多個平行操作。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 使用 Find 與 FindAsync 一節。
適用於
FindAsync(Type, Object[])
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。
public virtual System.Threading.Tasks.Task<object> FindAsync(Type entityType, params object[] keyValues);
public virtual System.Threading.Tasks.ValueTask<object?> FindAsync(Type entityType, params object?[]? keyValues);
public virtual System.Threading.Tasks.ValueTask<object> FindAsync(Type entityType, params object[] keyValues);
abstract member FindAsync : Type * obj[] -> System.Threading.Tasks.Task<obj>
override this.FindAsync : Type * obj[] -> System.Threading.Tasks.Task<obj>
abstract member FindAsync : Type * obj[] -> System.Threading.Tasks.ValueTask<obj>
override this.FindAsync : Type * obj[] -> System.Threading.Tasks.ValueTask<obj>
Public Overridable Function FindAsync (entityType As Type, ParamArray keyValues As Object()) As Task(Of Object)
Public Overridable Function FindAsync (entityType As Type, ParamArray keyValues As Object()) As ValueTask(Of Object)
參數
- entityType
- Type
該尋找的實體類型。
- keyValues
- Object[]
要找到實體的主鍵值。
傳回
找到的實體,或 null。
備註
Entity Framework Core 不支援在同一個 DbContext 實例上執行多個平行操作。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 使用 Find 與 FindAsync 一節。
適用於
FindAsync<TEntity>(Object[])
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。
public virtual System.Threading.Tasks.Task<TEntity> FindAsync<TEntity>(params object[] keyValues) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<TEntity?> FindAsync<TEntity>(params object?[]? keyValues) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync<TEntity>(params object[] keyValues) where TEntity : class;
abstract member FindAsync : obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
override this.FindAsync : obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
abstract member FindAsync : obj[] -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)> (requires 'Entity : null)
override this.FindAsync : obj[] -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)> (requires 'Entity : null)
Public Overridable Function FindAsync(Of TEntity As Class) (ParamArray keyValues As Object()) As Task(Of TEntity)
Public Overridable Function FindAsync(Of TEntity As Class) (ParamArray keyValues As Object()) As ValueTask(Of TEntity)
類型參數
- TEntity
該尋找的實體類型。
參數
- keyValues
- Object[]
要找到實體的主鍵值。
傳回
找到的實體,或 null。
備註
Entity Framework Core 不支援在同一個 DbContext 實例上執行多個平行操作。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 使用 Find 與 FindAsync 一節。
適用於
FindAsync<TEntity>(Object[], CancellationToken)
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
- 來源:
- DbContext.cs
尋找具有給定主鍵值的實體。 如果上下文追蹤的是具有相同主鍵值的實體,則該實體會立即回傳,無需向資料庫提出請求。 否則,會向資料庫查詢具有給定主鍵值的實體,若找到該實體,會附加到上下文中並回傳。 若未找到實體,則回傳 null。
public virtual System.Threading.Tasks.Task<TEntity> FindAsync<TEntity>(object[] keyValues, System.Threading.CancellationToken cancellationToken) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<TEntity?> FindAsync<TEntity>(object?[]? keyValues, System.Threading.CancellationToken cancellationToken) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync<TEntity>(object[] keyValues, System.Threading.CancellationToken cancellationToken) where TEntity : class;
abstract member FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
override this.FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
abstract member FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)> (requires 'Entity : null)
override this.FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)> (requires 'Entity : null)
Public Overridable Function FindAsync(Of TEntity As Class) (keyValues As Object(), cancellationToken As CancellationToken) As Task(Of TEntity)
Public Overridable Function FindAsync(Of TEntity As Class) (keyValues As Object(), cancellationToken As CancellationToken) As ValueTask(Of TEntity)
類型參數
- TEntity
該尋找的實體類型。
參數
- keyValues
- Object[]
要找到實體的主鍵值。
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
找到的實體,或 null。
例外狀況
備註
Entity Framework Core 不支援在同一個 DbContext 實例上執行多個平行操作。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 使用 Find 與 FindAsync 一節。