AsyncEnumerable.SingleOrDefaultAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken) |
Retorna o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken) |
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken) |
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken) |
Retorna o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken) |
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken) |
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição. |
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Retorna o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência.
public static System.Threading.Tasks.ValueTask<TSource?> SingleOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de origem.
Parâmetros
- source
- IAsyncEnumerable<TSource>
Um IAsyncEnumerable<T> para retornar o único elemento de.
- cancellationToken
- CancellationToken
O CancellationToken para monitorar solicitações de cancelamento. O padrão é None.
Retornos
O único elemento da sequência de entrada ou o valor padrão de TSource se a sequência não contiver elementos.
Exceções
source é null.
A source sequência contém mais de um elemento. (por meio da tarefa retornada).
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição.
public static System.Threading.Tasks.ValueTask<TSource?> SingleOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,bool> predicate, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, bool> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
Um IAsyncEnumerable<T> para retornar o único elemento de.
- cancellationToken
- CancellationToken
O CancellationToken para monitorar solicitações de cancelamento. O padrão é None.
Retornos
O único elemento da sequência de entrada que satisfaz a condição ou o valor padrão de TSource se nenhum elemento desse tipo for encontrado.
Exceções
predicate é null.
A sequência de entrada contém mais de um elemento.
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição.
public static System.Threading.Tasks.ValueTask<TSource?> SingleOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,System.Threading.CancellationToken,System.Threading.Tasks.ValueTask<bool>> predicate, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, System.Threading.CancellationToken, System.Threading.Tasks.ValueTask<bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, CancellationToken, ValueTask(Of Boolean)), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
Um IAsyncEnumerable<T> para retornar o único elemento de.
- predicate
- Func<TSource,CancellationToken,ValueTask<Boolean>>
Uma função para testar um elemento para uma condição.
- cancellationToken
- CancellationToken
O CancellationToken para monitorar solicitações de cancelamento. O padrão é None.
Retornos
O único elemento da sequência de entrada que satisfaz a condição ou o valor padrão de TSource se nenhum elemento desse tipo for encontrado.
Exceções
predicate é null.
A sequência de entrada contém mais de um elemento.
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Retorna o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência.
public static System.Threading.Tasks.ValueTask<TSource> SingleOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, TSource defaultValue, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * 'Source * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), defaultValue As TSource, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
Um IAsyncEnumerable<T> para retornar o único elemento de.
- defaultValue
- TSource
O valor padrão a ser retornado se a sequência estiver vazia.
- cancellationToken
- CancellationToken
O CancellationToken para monitorar solicitações de cancelamento. O padrão é None.
Retornos
O único elemento da sequência de entrada ou defaultValue se a sequência não contiver elementos.
Exceções
source é null.
A sequência de entrada contém mais de um elemento.
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição.
public static System.Threading.Tasks.ValueTask<TSource> SingleOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,bool> predicate, TSource defaultValue, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, bool> * 'Source * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), defaultValue As TSource, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
Um IAsyncEnumerable<T> do qual retornar um único elemento.
- defaultValue
- TSource
O valor padrão a ser retornado se a sequência estiver vazia.
- cancellationToken
- CancellationToken
O CancellationToken para monitorar solicitações de cancelamento. O padrão é None.
Retornos
O único elemento da sequência de entrada que satisfaz a condição ou defaultValue se nenhum elemento desse tipo for encontrado.
Exceções
predicate é null.
Mais de um elemento satisfaz a condição em predicate.
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Retorna o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo existir; esse método gerará uma exceção se mais de um elemento atender à condição.
public static System.Threading.Tasks.ValueTask<TSource> SingleOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,System.Threading.CancellationToken,System.Threading.Tasks.ValueTask<bool>> predicate, TSource defaultValue, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, System.Threading.CancellationToken, System.Threading.Tasks.ValueTask<bool>> * 'Source * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, CancellationToken, ValueTask(Of Boolean)), defaultValue As TSource, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
Um IAsyncEnumerable<T> do qual retornar um único elemento.
- predicate
- Func<TSource,CancellationToken,ValueTask<Boolean>>
Uma função para testar um elemento para uma condição.
- defaultValue
- TSource
O valor padrão a ser retornado se a sequência estiver vazia.
- cancellationToken
- CancellationToken
O CancellationToken para monitorar solicitações de cancelamento. O padrão é None.
Retornos
O único elemento da sequência de entrada que satisfaz a condição ou defaultValue se nenhum elemento desse tipo for encontrado.
Exceções
predicate é null.
Mais de um elemento satisfaz a condição em predicate.
