DbContext.FindAsync 方法

定義

命名空間:

Microsoft.EntityFrameworkCore

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v8.0.0

多載

FindAsync(Type, Object[], CancellationToken)	尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。
FindAsync(Type, Object[])	尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。
FindAsync<TEntity>(Object[])	尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。
FindAsync<TEntity>(Object[], CancellationToken)	尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。

FindAsync(Type, Object[], CancellationToken)

尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。

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.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 ValueTask(Of Object)

參數

entityType

Type

要尋找的實體類型。

keyValues

Object[]

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

cancellationToken

CancellationToken

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

傳回

ValueTask<Object>

找到的實體，或 null 。

例外狀況

OperationCanceledException

如果取消 CancellationToken。

備註

Entity Framework Core 不支援在相同的 DbCoNtext 實例上執行多個平行作業。 這包括平行執行非同步查詢，以及明確同時使用多個執行緒。 因此，請一律立即等候非同步呼叫，或針對平行執行的作業使用個別的 DbCoNtext 實例。 如需詳細資訊和範例，請參閱 避免 DbCoNtext 執行緒問題 。

如需詳細資訊和範例，請參閱 使用 Find 和 FindAsync 。

FindAsync(Type, Object[])

尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。

public virtual System.Threading.Tasks.ValueTask<object?> FindAsync (Type entityType, params object?[]? keyValues);

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 ValueTask(Of Object)

參數

entityType

Type

要尋找的實體類型。

keyValues

Object[]

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

傳回

ValueTask<Object>

找到的實體，或 null 。

備註

Entity Framework Core 不支援在相同的 DbCoNtext 實例上執行多個平行作業。 這包括平行執行非同步查詢，以及明確同時使用多個執行緒。 因此，請一律立即等候非同步呼叫，或針對平行執行的作業使用個別的 DbCoNtext 實例。 如需詳細資訊和範例，請參閱 避免 DbCoNtext 執行緒問題 。

如需詳細資訊和範例，請參閱 使用 Find 和 FindAsync 。

FindAsync<TEntity>(Object[])

尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。

public virtual System.Threading.Tasks.ValueTask<TEntity?> FindAsync<TEntity> (params object?[]? keyValues) where TEntity : class;

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 ValueTask(Of TEntity)

類型參數

TEntity

要尋找的實體類型。

參數

keyValues

Object[]

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

傳回

ValueTask<TEntity>

找到的實體，或 null 。

備註

Entity Framework Core 不支援在相同的 DbCoNtext 實例上執行多個平行作業。 這包括平行執行非同步查詢，以及明確同時使用多個執行緒。 因此，請一律立即等候非同步呼叫，或針對平行執行的作業使用個別的 DbCoNtext 實例。 如需詳細資訊和範例，請參閱 避免 DbCoNtext 執行緒問題 。

如需詳細資訊和範例，請參閱 使用 Find 和 FindAsync 。

FindAsync<TEntity>(Object[], CancellationToken)

尋找具有給定主索引鍵值的實體。 如果內容正在追蹤具有指定主鍵值的實體，則會立即傳回該實體，而不需要對資料庫提出要求。 否則，系統會針對具有指定主鍵值之實體的資料庫進行查詢，如果找到，則會附加至內容並傳回此實體。 如果找不到實體，則會傳回 null。

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.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 ValueTask(Of TEntity)

類型參數

TEntity

要尋找的實體類型。

參數

keyValues

Object[]

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

cancellationToken

CancellationToken

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

傳回

ValueTask<TEntity>

找到的實體，或 null 。

例外狀況

OperationCanceledException

如果取消 CancellationToken。

備註

Entity Framework Core 不支援在相同的 DbCoNtext 實例上執行多個平行作業。 這包括平行執行非同步查詢，以及明確同時使用多個執行緒。 因此，請一律立即等候非同步呼叫，或針對平行執行的作業使用個別的 DbCoNtext 實例。 如需詳細資訊和範例，請參閱 避免 DbCoNtext 執行緒問題 。

如需詳細資訊和範例，請參閱 使用 Find 和 FindAsync 。