EntityFrameworkQueryableExtensions.SingleOrDefaultAsync 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
| Nom | Description |
|---|---|
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Retourne de façon asynchrone le seul élément d’une séquence, ou une valeur par défaut si la séquence est vide ; cette méthode lève une exception s’il existe plusieurs éléments dans la séquence. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Retourne de façon asynchrone le seul élément d’une séquence qui satisfait à une condition spécifiée ou à une valeur par défaut s’il n’existe aucun élément de ce type ; cette méthode lève une exception si plusieurs éléments répondent à la condition. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Retourne de façon asynchrone le seul élément d’une séquence, ou une valeur par défaut si la séquence est vide ; cette méthode lève une exception s’il existe plusieurs éléments dans la séquence.
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)Paramètres de type
- TSource
Type des éléments de source.
Paramètres
- source
- IQueryable<TSource>
Pour IQueryable<T> renvoyer l’élément unique de.
- cancellationToken
- CancellationToken
À CancellationToken observer lors de l’attente de la fin de la tâche.
Retours
Tâche qui représente l’opération asynchrone.
Le résultat de la tâche contient l’élément unique de la séquence d’entrée, ou default ( TSource) si la séquence ne contient aucun élément.
Exceptions
source a la valeur null.
source contient plusieurs éléments.
Si la CancellationToken valeur est annulée.
Remarques
Plusieurs opérations actives sur la même instance de contexte ne sont pas prises en charge. Permet await de s’assurer que toutes les opérations asynchrones ont été effectuées avant d’appeler une autre méthode sur ce contexte. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de threading DbContext .
Pour plus d’informations et d’exemples, consultez l’interrogation de données avec EF Core .
S’applique à
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Retourne de façon asynchrone le seul élément d’une séquence qui satisfait à une condition spécifiée ou à une valeur par défaut s’il n’existe aucun élément de ce type ; cette méthode lève une exception si plusieurs éléments répondent à la condition.
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)Paramètres de type
- TSource
Type des éléments de source.
Paramètres
- source
- IQueryable<TSource>
Pour IQueryable<T> renvoyer l’élément unique de.
- predicate
- Expression<Func<TSource,Boolean>>
Fonction permettant de tester un élément pour une condition.
- cancellationToken
- CancellationToken
À CancellationToken observer lors de l’attente de la fin de la tâche.
Retours
Tâche qui représente l’opération asynchrone.
Le résultat de la tâche contient l’élément unique de la séquence d’entrée qui satisfait à la condition dans predicate, ou default ( TSource ) si aucun élément de ce type n’est trouvé.
Exceptions
source ou predicate est null.
Plusieurs éléments répondent à la condition dans predicate.
Si la CancellationToken valeur est annulée.
Remarques
Plusieurs opérations actives sur la même instance de contexte ne sont pas prises en charge. Permet await de s’assurer que toutes les opérations asynchrones ont été effectuées avant d’appeler une autre méthode sur ce contexte. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de threading DbContext .
Pour plus d’informations et d’exemples, consultez l’interrogation de données avec EF Core .
