EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Restituisce in modo asincrono l'unico elemento di una sequenza o un valore predefinito se la sequenza è vuota; questo metodo genera un'eccezione se nella sequenza sono presenti più elementi. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Restituisce in modo asincrono l'unico elemento di una sequenza che soddisfa una condizione specificata o un valore predefinito se tale elemento non esiste; questo metodo genera un'eccezione se più di un elemento soddisfa la condizione. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Restituisce in modo asincrono l'unico elemento di una sequenza o un valore predefinito se la sequenza è vuota; questo metodo genera un'eccezione se nella sequenza sono presenti più elementi.
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.Task<TSource?> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);
static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)
Parametri di tipo
- TSource
Tipo degli elementi di source.
Parametri
- source
- IQueryable<TSource>
Oggetto IQueryable<T> per restituire il singolo elemento di .
- cancellationToken
- CancellationToken
Oggetto CancellationToken da osservare durante l'attesa del completamento dell'attività.
Valori restituiti
Attività che rappresenta l'operazione asincrona.
Il risultato dell'attività contiene il singolo elemento della sequenza di input o default ( TSource) se la sequenza non contiene elementi.
Eccezioni
source è null.
source contiene più di un elemento.
Se l'oggetto CancellationToken viene annullato.
Commenti
Non sono supportate più operazioni attive nella stessa istanza di contesto. Usare await per assicurarsi che tutte le operazioni asincrone siano state completate prima di chiamare un altro metodo in questo contesto. Per altre informazioni ed esempi, vedere Evitare problemi di threading DbContext .
Per altre informazioni ed esempi, vedere Esecuzione di query sui dati con EF Core .
Si applica a
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Restituisce in modo asincrono l'unico elemento di una sequenza che soddisfa una condizione specificata o un valore predefinito se tale elemento non esiste; questo metodo genera un'eccezione se più di un elemento soddisfa la condizione.
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.Task<TSource?> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);
static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)
Parametri di tipo
- TSource
Tipo degli elementi di source.
Parametri
- source
- IQueryable<TSource>
Oggetto IQueryable<T> per restituire il singolo elemento di .
- predicate
- Expression<Func<TSource,Boolean>>
Funzione per testare un elemento per una condizione.
- cancellationToken
- CancellationToken
Oggetto CancellationToken da osservare durante l'attesa del completamento dell'attività.
Valori restituiti
Attività che rappresenta l'operazione asincrona.
Il risultato dell'attività contiene il singolo elemento della sequenza di input che soddisfa la condizione in predicateo default ( TSource ) se non viene trovato alcun elemento di questo tipo.
Eccezioni
source o predicate è null.
Più di un elemento soddisfa la condizione in predicate.
Se l'oggetto CancellationToken viene annullato.
Commenti
Non sono supportate più operazioni attive nella stessa istanza di contesto. Usare await per assicurarsi che tutte le operazioni asincrone siano state completate prima di chiamare un altro metodo in questo contesto. Per altre informazioni ed esempi, vedere Evitare problemi di threading DbContext .
Per altre informazioni ed esempi, vedere Esecuzione di query sui dati con EF Core .