DbSet<TEntity>.FindAsync (Método) (CancellationToken, Object[])
[Esta página es específica de la versión 6 de Entity Framework. La versión más reciente está disponible como el paquete NuGet de Entity Framework. Para más información sobre Entity Framework, consulte msdn.com/es-ES/data/ef].
Busca de forma asincrónica una entidad con los valores de clave principal especificados. Si en el contexto existe una entidad con los valores de clave principal especificados, se devuelve inmediatamente sin realizar una solicitud al almacenamiento. De lo contrario, se realiza una solicitud al almacén para una entidad con los valores de clave principal determinados y esta entidad, si se encuentra, se adjunta al contexto y se devuelve. Si no se encuentra ninguna entidad en el contexto o en el almacén, se devuelve null.
Espacio de nombres: System.Data.Entity
Ensamblado: EntityFramework (en EntityFramework.dll)
Sintaxis
'Declaración
Public Overridable Function FindAsync ( _
cancellationToken As CancellationToken, _
ParamArray keyValues As Object() _
) As Task(Of TEntity)
'Uso
Dim instance As DbSet
Dim cancellationToken As CancellationToken
Dim keyValues As Object()
Dim returnValue As Task(Of TEntity)
returnValue = instance.FindAsync(cancellationToken, _
keyValues)
public virtual Task<TEntity> FindAsync(
CancellationToken cancellationToken,
params Object[] keyValues
)
public:
virtual Task<TEntity>^ FindAsync(
CancellationToken cancellationToken,
... array<Object^>^ keyValues
)
abstract FindAsync :
cancellationToken:CancellationToken *
keyValues:Object[] -> Task<'TEntity>
override FindAsync :
cancellationToken:CancellationToken *
keyValues:Object[] -> Task<'TEntity>
public function FindAsync(
cancellationToken : CancellationToken,
... keyValues : Object[]
) : Task<TEntity>
Parámetros
- cancellationToken
Tipo: System.Threading.CancellationToken
CancellationToken que se va a observar mientras se espera que se complete la tarea.
- keyValues
Tipo: System.Object[]
Los valores de la clave principal para la entidad que se van a encontrar.
Valor devuelto
Tipo: System.Threading.Tasks.Task<TEntity>
Tarea que representa la operación asincrónica de búsqueda.El resultado de la tarea contiene la entidad encontrada o NULL.
Excepciones
Excepción | Condición |
---|---|
InvalidOperationException | Se produce si existen varias entidades en el contexto con los valores de clave principal especificados. |
InvalidOperationException | Se produce si el tipo de entidad no forma parte del modelo de datos para este contexto. |
InvalidOperationException | Se produce si los tipos de los valores de clave no coinciden con los tipos de los valores de clave para el tipo de entidad que se va a buscar. |
InvalidOperationException | Se inicia si el contexto se ha eliminado. |
Comentarios
La ordenación de valores principales compuestos es la definida en el EDM, que a su vez es la definida en el diseñador mediante la API fluida de Code First o mediante el atributo DataMember. No se admiten varias operaciones activas en la misma instancia de contexto. Use 'await' para asegurarse de que se han completado todas las operaciones asincrónicas antes de llamar a otro método en este contexto.