DbSet<TEntity>.FindAsync-Methode (CancellationToken, Object[])
[Diese Seite bezieht sich auf Entity Framework Version 6. Die neueste Version ist als 'Entity Framework' NuGet-Paket verfügbar. Weitere Informationen zu Entity Framework finden Sie unter msdn.com/data/ef.]
Sucht asynchron eine Entität mit den angegebenen Primärschlüsselwerten. Wenn eine Entität mit den angegebenen Primärschlüsselwerten im Kontext vorhanden ist, wird sie sofort zurückgegeben, ohne eine Anforderung an den Speicher auszuführen. Andernfalls wird eine Entität mit den angegebenen Primärschlüsselwerten vom Speicher angefordert, und wenn diese Entität gefunden wird, wird sie an den Kontext angefügt und zurückgegeben. Wenn keine Entität im Kontext oder Speicher gefunden wird, wird NULL zurückgegeben.
Namespace: System.Data.Entity
Assembly: EntityFramework (in EntityFramework.dll)
Syntax
'Declaration
Public Overridable Function FindAsync ( _
cancellationToken As CancellationToken, _
ParamArray keyValues As Object() _
) As Task(Of TEntity)
'Usage
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>
Parameter
- cancellationToken
Typ: System.Threading.CancellationToken
Ein CancellationToken, das beim Warten auf den Abschluss der Aufgabe überwacht werden soll.
- keyValues
Typ: System.Object[]
Die Werte des Primärschlüssels für die gesuchte Entität.
Rückgabewert
Typ: System.Threading.Tasks.Task<TEntity>
Eine Aufgabe, die den asynchronen Suchvorgang darstellt.Das Aufgabeergebnis enthält die gefundene Entität oder NULL.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Wird ausgelöst, wenn mehrere Entitäten mit den angegebenen Primärschlüsselwerten im Kontext vorhanden sind. |
| InvalidOperationException | Wird ausgelöst, wenn der Entitätstyp nicht Teil des Datenmodells für diesen Kontext ist. |
| InvalidOperationException | Wird ausgelöst, wenn die Schlüsselwerte nicht zu den Typen der Schlüsselwerte für den gefundenen Entitätstyp passen. |
| InvalidOperationException | Wird ausgelöst, wenn der Kontext verworfen wurde. |
Hinweise
Die Reihenfolge der Werte zusammengesetzter Schlüssel entspricht der Definition im EDM, die wiederum im Designer, durch die Code First Fluent-API oder durch das DataMember-Attribut definiert ist. Mehrere aktive Vorgänge für dieselbe Kontextinstanz werden nicht unterstützt. Verwenden Sie await, um sicherzustellen, dass sämtliche asynchronen Vorgänge abgeschlossen sind, bevor eine andere Methode in diesem Kontext aufgerufen wird.