DbContext.FindAsync Método

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v9.0.0

Sobrecargas

FindAsync(Type, 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(Type, 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<TEntity>(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<TEntity>(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(Type, Object[], CancellationToken)

Origem:

DbContext.cs

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.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)

Parâmetros

entityType

Type

O tipo de entidade a ser encontrada.

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

ValueTask<Object>

A entidade encontrada, ou null.

Exceções

OperationCanceledException

Se o padrão CancellationToken for cancelado.

Comentários

O Entity Framework Core não dá suporte a várias operações paralelas que estão sendo executadas na mesma instância DbContext. Isso inclui a execução paralela de consultas assíncronas e qualquer uso simultâneo explícito de vários threads. Portanto, sempre aguarde chamadas assíncronas imediatamente ou use instâncias DbContext separadas para operações executadas em paralelo. Consulte Evitando problemas de threading DbContext para obter mais informações e exemplos.

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

FindAsync(Type, Object[])

Origem:

DbContext.cs

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.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)

Parâmetros

entityType

Type

O tipo de entidade a ser encontrada.

keyValues

Object[]

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

Retornos

ValueTask<Object>

A entidade encontrada, ou null.

Comentários

O Entity Framework Core não dá suporte a várias operações paralelas que estão sendo executadas na mesma instância DbContext. Isso inclui a execução paralela de consultas assíncronas e qualquer uso simultâneo explícito de vários threads. Portanto, sempre aguarde chamadas assíncronas imediatamente ou use instâncias DbContext separadas para operações executadas em paralelo. Consulte Evitando problemas de threading DbContext para obter mais informações e exemplos.

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

FindAsync<TEntity>(Object[])

Origem:

DbContext.cs

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.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)

Parâmetros de tipo

TEntity

O tipo de entidade a ser encontrada.

Parâmetros

keyValues

Object[]

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

Retornos

ValueTask<TEntity>

A entidade encontrada, ou null.

Comentários

O Entity Framework Core não dá suporte a várias operações paralelas que estão sendo executadas na mesma instância DbContext. Isso inclui a execução paralela de consultas assíncronas e qualquer uso simultâneo explícito de vários threads. Portanto, sempre aguarde chamadas assíncronas imediatamente ou use instâncias DbContext separadas para operações executadas em paralelo. Consulte Evitando problemas de threading DbContext para obter mais informações e exemplos.

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

FindAsync<TEntity>(Object[], CancellationToken)

Origem:

DbContext.cs

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.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)

Parâmetros de tipo

TEntity

O tipo de entidade a ser encontrada.

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

ValueTask<TEntity>

A entidade encontrada, ou null.

Exceções

OperationCanceledException

Se o padrão CancellationToken for cancelado.

Comentários

O Entity Framework Core não dá suporte a várias operações paralelas que estão sendo executadas na mesma instância DbContext. Isso inclui a execução paralela de consultas assíncronas e qualquer uso simultâneo explícito de vários threads. Portanto, sempre aguarde chamadas assíncronas imediatamente ou use instâncias DbContext separadas para operações executadas em paralelo. Consulte Evitando problemas de threading DbContext para obter mais informações e exemplos.

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