QueryableExtensions.SingleOrDefaultAsync<TSource>, méthode (IQueryable<TSource>, CancellationToken)
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
Retourne de façon asynchrone l'élément unique d'une séquence ou une valeur par défaut si la séquence est vide. Cette méthode lève une exception si cette séquence contient plusieurs éléments.
Espace de noms : System.Data.Entity
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
<ExtensionAttribute> _
Public Shared Function SingleOrDefaultAsync(Of TSource) ( _
source As IQueryable(Of TSource), _
cancellationToken As CancellationToken _
) As Task(Of TSource)
'Utilisation
Dim source As IQueryable(Of TSource)
Dim cancellationToken As CancellationToken
Dim returnValue As Task(Of TSource)
returnValue = source.SingleOrDefaultAsync(cancellationToken)
public static Task<TSource> SingleOrDefaultAsync<TSource>(
this IQueryable<TSource> source,
CancellationToken cancellationToken
)
[ExtensionAttribute]
public:
generic<typename TSource>
static Task<TSource>^ SingleOrDefaultAsync(
IQueryable<TSource>^ source,
CancellationToken cancellationToken
)
static member SingleOrDefaultAsync :
source:IQueryable<'TSource> *
cancellationToken:CancellationToken -> Task<'TSource>
JScript does not support generic types and methods.
Paramètres de type
- TSource
Type des éléments de source.
Paramètres
- source
Type : System.Linq.IQueryable<TSource>
IQueryable<T> duquel retourner le seul élément.
- cancellationToken
Type : System.Threading.CancellationToken
CancellationToken à observer en attendant que la tâche se termine.
Valeur de retour
Type : System.Threading.Tasks.Task<TSource>
Tâche qui représente l'opération asynchrone.Le résultat de la tâche contient le seul élément de la séquence d'entrée, ou default (TSource) si la séquence ne contient aucun élément.
Remarque sur l'utilisation
En Visual Basic et C#, vous pouvez appeler cette méthode comme une méthode d'instance sur n'importe quel objet de type IQueryable<TSource>. Lorsque vous utilisez la syntaxe des méthodes d'instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d'informations, consultez https://msdn.microsoft.com/fr-fr/library/bb384936(v=vs.113) ou https://msdn.microsoft.com/fr-fr/library/bb383977(v=vs.113).
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | source a la valeur null. |
| InvalidOperationException | source n'implémente pas IDbAsyncQueryProvider. |
| InvalidOperationException | source a plusieurs éléments. |
Notes
Plusieurs opérations actives sur la même instance de contexte ne sont pas prises en charge. Utilisez « await » pour garantir que toutes les opérations asynchrones sont terminées avant d'appeler une autre méthode dans ce contexte.