DbSet<TEntity>.FindAsync Método

  • Referência

Definição

Namespace:
Microsoft.EntityFrameworkCore
Assembly:
Microsoft.EntityFrameworkCore.dll
Pacote:
Microsoft.EntityFrameworkCore v1.1.6
Pacote:
Microsoft.EntityFrameworkCore v2.0.3
Pacote:
Microsoft.EntityFrameworkCore v2.1.11
Pacote:
Microsoft.EntityFrameworkCore v2.2.6
Pacote:
Microsoft.EntityFrameworkCore v3.0.0
Pacote:
Microsoft.EntityFrameworkCore v3.1.0
Pacote:
Microsoft.EntityFrameworkCore v5.0.0
Pacote:
Microsoft.EntityFrameworkCore v6.0.0
Pacote:
Microsoft.EntityFrameworkCore v7.0.0
Pacote:
Microsoft.EntityFrameworkCore v8.0.0

Sobrecargas

FindAsync(Object[])

Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.
FindAsync(Object[], CancellationToken)

Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.

FindAsync(Object[])

Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.

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)

Parâmetros

keyValues
Object[]

Os valores da chave primária para a entidade a ser encontrada.

Retornos

Task<TEntity>
ValueTask<TEntity>

A entidade encontrada, ou null.

Comentários

Consulte Usando Localizar e LocalizarAsync para obter mais informações e exemplos.

Aplica-se a

FindAsync(Object[], CancellationToken)

Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.

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)

Parâmetros

keyValues
Object[]

Os valores da chave primária para a entidade a ser encontrada.

cancellationToken
CancellationToken

Um CancellationToken a ser observado enquanto aguarda a conclusão da tarefa.

Retornos

Task<TEntity>
ValueTask<TEntity>

A entidade encontrada, ou null.

Exceções

OperationCanceledException

Se o padrão CancellationToken for cancelado.

Comentários

Consulte Usando Localizar e LocalizarAsync para obter mais informações e exemplos.

Aplica-se a