DbSet<TEntity>.FindAsync メソッド

  • リファレンス

定義

名前空間:
Microsoft.EntityFrameworkCore
アセンブリ:
Microsoft.EntityFrameworkCore.dll
パッケージ:
Microsoft.EntityFrameworkCore v1.1.6
パッケージ:
Microsoft.EntityFrameworkCore v2.0.3
パッケージ:
Microsoft.EntityFrameworkCore v2.1.11
パッケージ:
Microsoft.EntityFrameworkCore v2.2.6
パッケージ:
Microsoft.EntityFrameworkCore v3.0.0
パッケージ:
Microsoft.EntityFrameworkCore v3.1.0
パッケージ:
Microsoft.EntityFrameworkCore v5.0.0
パッケージ:
Microsoft.EntityFrameworkCore v6.0.0
パッケージ:
Microsoft.EntityFrameworkCore v7.0.0
パッケージ:
Microsoft.EntityFrameworkCore v8.0.0

オーバーロード

FindAsync(Object[])

指定された主キー値を持つエンティティを検索します。 指定された主キー値を持つエンティティがコンテキストによって追跡されている場合は、データベースに要求を行わずにすぐに返されます。 それ以外の場合は、指定された主キー値を持つエンティティのデータベースに対してクエリが実行され、このエンティティが見つかった場合はコンテキストにアタッチされ、返されます。 エンティティが見つからない場合は、null が返されます。
FindAsync(Object[], CancellationToken)

指定された主キー値を持つエンティティを検索します。 指定された主キー値を持つエンティティがコンテキストによって追跡されている場合は、データベースに要求を行わずにすぐに返されます。 それ以外の場合は、指定された主キー値を持つエンティティのデータベースに対してクエリが実行され、このエンティティが見つかった場合はコンテキストにアタッチされ、返されます。 エンティティが見つからない場合は、null が返されます。

FindAsync(Object[])

指定された主キー値を持つエンティティを検索します。 指定された主キー値を持つエンティティがコンテキストによって追跡されている場合は、データベースに要求を行わずにすぐに返されます。 それ以外の場合は、指定された主キー値を持つエンティティのデータベースに対してクエリが実行され、このエンティティが見つかった場合はコンテキストにアタッチされ、返されます。 エンティティが見つからない場合は、null が返されます。

public virtual System.Threading.Tasks.Task<TEntity> FindAsync (params object[] keyValues);
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync (params object[] keyValues);
public virtual System.Threading.Tasks.ValueTask<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)>
abstract member FindAsync : obj[] -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
override this.FindAsync : obj[] -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
Public Overridable Function FindAsync (ParamArray keyValues As Object()) As Task(Of TEntity)
Public Overridable Function FindAsync (ParamArray keyValues As Object()) As ValueTask(Of TEntity)

パラメーター

keyValues
Object[]

検索するエンティティの主キー値。

戻り値

Task<TEntity>
ValueTask<TEntity>

見つかったエンティティ。または null。

注釈

詳細と例については、「 Find と FindAsync の使用 」を参照してください。

適用対象

FindAsync(Object[], CancellationToken)

指定された主キー値を持つエンティティを検索します。 指定された主キー値を持つエンティティがコンテキストによって追跡されている場合は、データベースに要求を行わずにすぐに返されます。 それ以外の場合は、指定された主キー値を持つエンティティのデータベースに対してクエリが実行され、このエンティティが見つかった場合はコンテキストにアタッチされ、返されます。 エンティティが見つからない場合は、null が返されます。

public virtual System.Threading.Tasks.Task<TEntity> FindAsync (object[] keyValues, System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync (object[] keyValues, System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<TEntity?> FindAsync (object?[]? keyValues, System.Threading.CancellationToken cancellationToken);
abstract member FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
override this.FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)>
abstract member FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
override this.FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Entity (requires 'Entity : null)>
Public Overridable Function FindAsync (keyValues As Object(), cancellationToken As CancellationToken) As Task(Of TEntity)
Public Overridable Function FindAsync (keyValues As Object(), cancellationToken As CancellationToken) As ValueTask(Of TEntity)

パラメーター

keyValues
Object[]

検索するエンティティの主キー値。

cancellationToken
CancellationToken

CancellationTokenタスクの完了を待機している間に観察する 。

戻り値

Task<TEntity>
ValueTask<TEntity>

見つかったエンティティ。または null。

例外

OperationCanceledException

CancellationToken が取り消されている場合。

注釈

詳細と例については、「 Find と FindAsync の使用 」を参照してください。

適用対象