QueryableExtensions.SingleOrDefaultAsync<TSource> (Método) (IQueryable<TSource>, CancellationToken)
[Esta página es específica de la versión 6 de Entity Framework. La versión más reciente está disponible como el paquete NuGet de Entity Framework. Para más información sobre Entity Framework, consulte msdn.com/es-ES/data/ef].
Devuelve de forma asincrónica el único elemento de una secuencia o un valor predeterminado si la secuencia está vacía; este método produce una excepción si hay más de un elemento en la secuencia.
Espacio de nombres: System.Data.Entity
Ensamblado: EntityFramework (en EntityFramework.dll)
Sintaxis
'Declaración
<ExtensionAttribute> _
Public Shared Function SingleOrDefaultAsync(Of TSource) ( _
source As IQueryable(Of TSource), _
cancellationToken As CancellationToken _
) As Task(Of TSource)
'Uso
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.
Parámetros de tipo
- TSource
Tipo de los elementos de source.
Parámetros
- source
Tipo: System.Linq.IQueryable<TSource>
IQueryable<T> cuyo único elemento se va a devolver.
- cancellationToken
Tipo: System.Threading.CancellationToken
CancellationToken que se va a observar mientras se espera que se complete la tarea.
Valor devuelto
Tipo: System.Threading.Tasks.Task<TSource>
Tarea que representa la operación asincrónica.El resultado de la tarea contiene el único elemento de la secuencia de entrada, o default (TSource) si la secuencia no contiene ningún elemento.
Nota sobre el uso
En Visual Basic y C#, se puede llamar a este método como a un método de instancia en cualquier objeto de tipo IQueryable<TSource>. Cuando emplee la sintaxis del método de instancia para llamar a este método, omita el primer parámetro. Para obtener más información, vea https://msdn.microsoft.com/es-es/library/bb384936(v=vs.113) o https://msdn.microsoft.com/es-es/library/bb383977(v=vs.113).
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentNullException | source es null. |
| InvalidOperationException | source no implementa IDbAsyncQueryProvider. |
| InvalidOperationException | source tiene más de un elemento. |
Comentarios
No se admiten varias operaciones activas en la misma instancia de contexto. Use 'await' para asegurarse de que se han completado todas las operaciones asincrónicas antes de llamar a otro método en este contexto.