Partager via


EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Méthode

Définition

Surcharges

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière 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 manière asynchrone le seul élément d’une séquence qui satisfait à une condition spécifiée ou à une valeur par défaut si aucun élément de ce type n’existe ; cette méthode lève une exception si plusieurs éléments satisfont à la condition.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière 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

Le type des éléments de source.

Paramètres

source
IQueryable<TSource>

IQueryable<T> duquel retourner le seul élément.

cancellationToken
CancellationToken

CancellationToken À observer en attendant la fin de la tâche.

Retours

Task<TSource>

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.

Remarques

Plusieurs opérations actives sur le même instance de contexte ne sont pas prises en charge. Permet await de vérifier que toutes les opérations asynchrones sont terminées avant d’appeler une autre méthode sur ce contexte. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .

Pour plus d’informations et d’exemples , consultez Interrogation de données avec EF Core .

S’applique à

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le seul élément d’une séquence qui satisfait à une condition spécifiée ou à une valeur par défaut si aucun élément de ce type n’existe ; cette méthode lève une exception si plusieurs éléments satisfont à 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

Le type des éléments de source.

Paramètres

source
IQueryable<TSource>

IQueryable<T> duquel retourner le seul élément.

predicate
Expression<Func<TSource,Boolean>>

Fonction permettant de tester un élément pour une condition.

cancellationToken
CancellationToken

CancellationToken À observer en attendant la fin de la tâche.

Retours

Task<TSource>

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 satisfont à la condition dans predicate.

Remarques

Plusieurs opérations actives sur le même instance de contexte ne sont pas prises en charge. Permet await de vérifier que toutes les opérations asynchrones sont terminées avant d’appeler une autre méthode sur ce contexte. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de thread dbContext .

Pour plus d’informations et d’exemples , consultez Interrogation de données avec EF Core .

S’applique à