DbSet.FindAsync, méthode (CancellationToken, Object[])
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
Recherche de façon asynchrone une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire données existe dans le contexte, elle est retournée immédiatement sans demande au magasin. Sinon, une demande d'entité avec les valeurs de clé primaire données est faite au magasin et cette entité, si trouvée, est jointe au contexte et retournée. Si aucune entité n'est trouvée dans le contexte ou le magasin, null est retourné.
Espace de noms : System.Data.Entity
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
Public Overridable Function FindAsync ( _
cancellationToken As CancellationToken, _
ParamArray keyValues As Object() _
) As Task(Of Object)
'Utilisation
Dim instance As DbSet
Dim cancellationToken As CancellationToken
Dim keyValues As Object()
Dim returnValue As Task(Of Object)
returnValue = instance.FindAsync(cancellationToken, _
keyValues)
public virtual Task<Object> FindAsync(
CancellationToken cancellationToken,
params Object[] keyValues
)
public:
virtual Task<Object^>^ FindAsync(
CancellationToken cancellationToken,
... array<Object^>^ keyValues
)
abstract FindAsync :
cancellationToken:CancellationToken *
keyValues:Object[] -> Task<Object>
override FindAsync :
cancellationToken:CancellationToken *
keyValues:Object[] -> Task<Object>
public function FindAsync(
cancellationToken : CancellationToken,
... keyValues : Object[]
) : Task<Object>
Paramètres
- cancellationToken
Type : System.Threading.CancellationToken
CancellationToken à observer en attendant que la tâche se termine.
- keyValues
Type : System.Object[]
Valeurs de la clé primaire de l'entité à rechercher.
Valeur de retour
Type : System.Threading.Tasks.Task<Object>
Tâche qui représente l'opération de recherche asynchrone.Le résultat de la tâche contient l'entité trouvée ou Null.
Exceptions
Exception | Condition |
---|---|
InvalidOperationException | Exception levée si plusieurs entités existent dans le contexte avec les valeurs de clé primaire données. |
InvalidOperationException | Exception levée si le type d'entité ne fait pas partie du modèle de données de ce contexte. |
InvalidOperationException | Exception levée si les valeurs de clé ne correspondent pas aux valeurs de clé du type d'entité recherché. |
InvalidOperationException | Levée si le contexte a été supprimé. |
Notes
Le classement des valeurs de clé composite est tel que défini dans l'Entity Data Model, qui est à son tour défini comme dans le concepteur, par l'API Fluent Code First, ou par l'attribut DataMember. Plusieurs opérations actives sur la même instance de contexte ne sont pas prises en charge. Utilisez « await » pour garantir que toutes les opérations asynchrones sont terminées avant d'appeler une autre méthode dans ce contexte.