EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
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. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Devuelve de forma asincrónica el único elemento de una secuencia que satisface una condición especificada o un valor predeterminado si no existe dicho elemento; Este método produce una excepción si más de un elemento cumple la condición. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
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.
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)Parámetros de tipo
- TSource
Tipo de los elementos de source.
Parámetros
- source
- IQueryable<TSource>
IQueryable<T> cuyo único elemento se va a devolver.
- cancellationToken
- CancellationToken
que CancellationToken se va a observar mientras espera a que se complete la tarea.
Devoluciones
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.
Excepciones
source es null.
source contiene más de un elemento.
Si se cancela CancellationToken.
Comentarios
No se admiten varias operaciones activas en la misma instancia de contexto. Use await para asegurarse de que las operaciones asincrónicas se hayan completado antes de llamar a otro método en este contexto. Consulte Evitar problemas de subprocesos de DbContext para obtener más información y ejemplos.
Consulte Consulta de datos con EF Core para obtener más información y ejemplos.
Se aplica a
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Devuelve de forma asincrónica el único elemento de una secuencia que satisface una condición especificada o un valor predeterminado si no existe dicho elemento; Este método produce una excepción si más de un elemento cumple la condición.
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)Parámetros de tipo
- TSource
Tipo de los elementos de source.
Parámetros
- source
- IQueryable<TSource>
IQueryable<T> cuyo único elemento se va a devolver.
- predicate
- Expression<Func<TSource,Boolean>>
Función que va a probar si un elemento satisface una condición.
- cancellationToken
- CancellationToken
que CancellationToken se va a observar mientras espera a que se complete la tarea.
Devoluciones
Tarea que representa la operación asincrónica.
El resultado de la tarea contiene el único elemento de la secuencia de entrada que satisface la condición en predicate, o default ( TSource ) si no se encuentra dicho elemento.
Excepciones
source o predicate es null.
Varios elementos satisfacen la condición de predicate.
Si se cancela CancellationToken.
Comentarios
No se admiten varias operaciones activas en la misma instancia de contexto. Use await para asegurarse de que las operaciones asincrónicas se hayan completado antes de llamar a otro método en este contexto. Consulte Evitar problemas de subprocesos de DbContext para obtener más información y ejemplos.
Consulte Consulta de datos con EF Core para obtener más información y ejemplos.
