Metodo DbSet<TEntity>.FindAsync (CancellationToken, Object[])
[Questa pagina è specifica della versione 6 di Entity Framework. La versione più recente è disponibile come pacchetto NuGet per "Entity Framework". Per ulteriori informazioni su Entity Framework, vedere la pagina msdn.com/data/ef.]
Consente di trovare in modo asincrono un'entità con i valori della chiave primaria specificati. Se un'entità con i valori della chiave primaria specificati esiste nel contesto, verrà restituita immediatamente senza effettuare una richiesta all'archivio. In caso contrario, viene richiesta all'archivio un'entità con i valori della chiave primaria specificati. L'eventuale entità così trovata verrà associata al contesto e restituita. Se non viene trovata alcuna entità nel contesto né nell'archivio, viene restituito null.
Spazio dei nomi: System.Data.Entity
Assembly: EntityFramework (in EntityFramework.dll)
Sintassi
'Dichiarazione
Public Overridable Function FindAsync ( _
cancellationToken As CancellationToken, _
ParamArray keyValues As Object() _
) As Task(Of TEntity)
'Utilizzo
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>
Parametri
- cancellationToken
Tipo: System.Threading.CancellationToken
Oggetto CancellationToken da osservare durante l'attesa del completamento dell'attività.
- keyValues
Tipo: System.Object[]
Valori della chiave primaria dell'entità da trovare.
Valore restituito
Tipo: System.Threading.Tasks.Task<TEntity>
Attività che rappresenta l'operazione di ricerca asincrona.Il risultato dell'attività contiene l'entità trovata o Null.
Eccezioni
| Eccezione | Condizione |
|---|---|
| InvalidOperationException | Generata se esistono più entità nel contesto con i valori della chiave primaria specificati. |
| InvalidOperationException | Generata se il tipo di entità non fa parte del modello di dati per questo contesto. |
| InvalidOperationException | Generata se i tipi dei valori chiave non corrispondono ai tipi dei valori chiave per il tipo di entità da trovare. |
| InvalidOperationException | Generata se il contesto è stato eliminato. |
Note
L'ordine dei valori della chiave composta è quello definito in EDM, che a sua volta è quello definito nella finestra di progettazione, dall'API Code First di tipo Fluent o dall'attributo DataMember. Non è consentito eseguire più operazioni attive nella stessa istanza di contesto. Utilizzare 'await' per assicurarsi che eventuali operazioni asincrone vengano completate prima di chiamare un altro metodo su questo contesto.