EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Método

Definición

Espacio de nombres:

Microsoft.EntityFrameworkCore

Ensamblado:

Microsoft.EntityFrameworkCore.dll

Paquete:

Microsoft.EntityFrameworkCore v8.0.0

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);

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

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.

Excepciones

ArgumentNullException

source es null.

InvalidOperationException

source contiene más de un elemento.

OperationCanceledException

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.

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);

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

Task<TSource>

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

ArgumentNullException

source o predicate es null.

InvalidOperationException

Varios elementos satisfacen la condición de predicate.

OperationCanceledException

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.