EntityFrameworkQueryableExtensions.SingleAsync Méthode

Définition

Espace de noms:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v8.0.0

Surcharges

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	Retourne de façon asynchrone le seul élément d’une séquence et lève une exception s’il n’y a pas exactement un élément dans la séquence.
SingleAsync<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 et lève une exception si plusieurs éléments de ce type existent.

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

Retourne de façon asynchrone le seul élément d’une séquence et lève une exception s’il n’y a pas exactement un élément dans la séquence.

public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);

static member SingleAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleAsync(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.

Exceptions

ArgumentNullException

source a la valeur null.

InvalidOperationException

source contient plusieurs éléments.

-ou-

source ne contient aucun élément.

OperationCanceledException

Si le CancellationToken est annulé.

Remarques

Plusieurs opérations actives sur le même contexte instance ne sont pas prises en charge. Utilisez await pour vous assurer 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 .

SingleAsync<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 et lève une exception si plusieurs éléments de ce type existent.

public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);

static member SingleAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleAsync(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.

Exceptions

ArgumentNullException

source ou predicate est null.

InvalidOperationException

Aucun élément ne satisfait la condition dans predicate.

- ou -

Plusieurs éléments satisfont à la condition dans predicate.

- ou -

source ne contient aucun élément.

OperationCanceledException

Si le CancellationToken est annulé.

Remarques

Plusieurs opérations actives sur le même contexte instance ne sont pas prises en charge. Utilisez await pour vous assurer 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 .