DbContext.FindAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
FindAsync(Type, Object[], CancellationToken) |
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné. |
FindAsync(Type, Object[]) |
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné. |
FindAsync<TEntity>(Object[]) |
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné. |
FindAsync<TEntity>(Object[], CancellationToken) |
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné. |
FindAsync(Type, Object[], CancellationToken)
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné.
public virtual System.Threading.Tasks.Task<object> FindAsync (Type entityType, object[] keyValues, System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<object> FindAsync (Type entityType, object[] keyValues, System.Threading.CancellationToken cancellationToken);
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.Task<obj>
override this.FindAsync : Type * obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
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 Task(Of Object)
Public Overridable Function FindAsync (entityType As Type, keyValues As Object(), cancellationToken As CancellationToken) As ValueTask(Of Object)
Paramètres
- entityType
- Type
Type d’entité à rechercher.
- keyValues
- Object[]
Valeurs de la clé primaire de l'entité à rechercher.
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant la fin de la tâche.
Retours
Entité trouvée, ou null
.
Exceptions
Si le CancellationToken est annulé.
Remarques
Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours les appels asynchrones immédiatement ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .
Pour plus d’informations et d’exemples, consultez Utilisation de Find et FindAsync .
S’applique à
FindAsync(Type, Object[])
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné.
public virtual System.Threading.Tasks.Task<object> FindAsync (Type entityType, params object[] keyValues);
public virtual System.Threading.Tasks.ValueTask<object> FindAsync (Type entityType, params object[] keyValues);
public virtual System.Threading.Tasks.ValueTask<object?> FindAsync (Type entityType, params object?[]? keyValues);
abstract member FindAsync : Type * obj[] -> System.Threading.Tasks.Task<obj>
override this.FindAsync : Type * obj[] -> System.Threading.Tasks.Task<obj>
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 Task(Of Object)
Public Overridable Function FindAsync (entityType As Type, ParamArray keyValues As Object()) As ValueTask(Of Object)
Paramètres
- entityType
- Type
Type d’entité à rechercher.
- keyValues
- Object[]
Valeurs de la clé primaire de l'entité à rechercher.
Retours
Entité trouvée, ou null
.
Remarques
Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours les appels asynchrones immédiatement ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .
Pour plus d’informations et d’exemples, consultez Utilisation de Find et FindAsync .
S’applique à
FindAsync<TEntity>(Object[])
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné.
public virtual System.Threading.Tasks.Task<TEntity> FindAsync<TEntity> (params object[] keyValues) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync<TEntity> (params object[] keyValues) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<TEntity?> FindAsync<TEntity> (params object?[]? keyValues) where TEntity : class;
abstract member FindAsync : obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
override this.FindAsync : obj[] -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
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 Task(Of TEntity)
Public Overridable Function FindAsync(Of TEntity As Class) (ParamArray keyValues As Object()) As ValueTask(Of TEntity)
Paramètres de type
- TEntity
Type d’entité à rechercher.
Paramètres
- keyValues
- Object[]
Valeurs de la clé primaire de l'entité à rechercher.
Retours
Entité trouvée, ou null
.
Remarques
Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours les appels asynchrones immédiatement ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .
Pour plus d’informations et d’exemples, consultez Utilisation de Find et FindAsync .
S’applique à
FindAsync<TEntity>(Object[], CancellationToken)
Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire spécifiées est suivie par le contexte, elle est retournée immédiatement sans en faire la demande à la base de données. Sinon, une requête est effectuée dans la base de données pour une entité avec les valeurs de clé primaire spécifiées et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, null est retourné.
public virtual System.Threading.Tasks.Task<TEntity> FindAsync<TEntity> (object[] keyValues, System.Threading.CancellationToken cancellationToken) where TEntity : class;
public virtual System.Threading.Tasks.ValueTask<TEntity> FindAsync<TEntity> (object[] keyValues, System.Threading.CancellationToken cancellationToken) where TEntity : class;
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.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
override this.FindAsync : obj[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Entity (requires 'Entity : null)> (requires 'Entity : null)
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 Task(Of TEntity)
Public Overridable Function FindAsync(Of TEntity As Class) (keyValues As Object(), cancellationToken As CancellationToken) As ValueTask(Of TEntity)
Paramètres de type
- TEntity
Type d’entité à rechercher.
Paramètres
- keyValues
- Object[]
Valeurs de la clé primaire de l'entité à rechercher.
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant la fin de la tâche.
Retours
Entité trouvée, ou null
.
Exceptions
Si le CancellationToken est annulé.
Remarques
Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours les appels asynchrones immédiatement ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .
Pour plus d’informations et d’exemples, consultez Utilisation de Find et FindAsync .