AsyncEnumerable.SingleOrDefaultAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken) |
Devolve o único elemento de uma sequência, ou um valor padrão se a sequência estiver vazia; este método lança uma exceção se houver mais do que um elemento na sequência. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken) |
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a condição. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken) |
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a condição. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken) |
Devolve o único elemento de uma sequência, ou um valor padrão se a sequência estiver vazia; este método lança uma exceção se houver mais do que um elemento na sequência. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken) |
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a condição. |
| SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken) |
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a condição. |
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Devolve o único elemento de uma sequência, ou um valor padrão se a sequência estiver vazia; este método lança uma exceção se houver mais do que 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 Genérico
- TSource
O tipo dos elementos da fonte.
Parâmetros
- source
- IAsyncEnumerable<TSource>
E IAsyncEnumerable<T> para devolver o elemento único de .
- cancellationToken
- CancellationToken
O CancellationToken para monitorizar pedidos de cancelamento. A predefinição é None.
Devoluções
O elemento único 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 do que um elemento. (através da tarefa devolvida).
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a 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 Genérico
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
E IAsyncEnumerable<T> para devolver o elemento único de .
- cancellationToken
- CancellationToken
O CancellationToken para monitorizar pedidos de cancelamento. A predefinição é None.
Devoluções
O único elemento da sequência de entrada que satisfaz a condição, ou o valor padrão de TSource caso não seja encontrado tal elemento.
Exceções
predicate é null.
A sequência de entrada contém mais do que um elemento.
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a 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 Genérico
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
E IAsyncEnumerable<T> para devolver o elemento único de .
- predicate
- Func<TSource,CancellationToken,ValueTask<Boolean>>
Uma função para testar um elemento para uma condição.
- cancellationToken
- CancellationToken
O CancellationToken para monitorizar pedidos de cancelamento. A predefinição é None.
Devoluções
O único elemento da sequência de entrada que satisfaz a condição, ou o valor padrão de TSource caso não seja encontrado tal elemento.
Exceções
predicate é null.
A sequência de entrada contém mais do que um elemento.
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Devolve o único elemento de uma sequência, ou um valor padrão se a sequência estiver vazia; este método lança uma exceção se houver mais do que 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 Genérico
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
E IAsyncEnumerable<T> para devolver o elemento único de .
- defaultValue
- TSource
O valor padrão a devolver se a sequência estiver vazia.
- cancellationToken
- CancellationToken
O CancellationToken para monitorizar pedidos de cancelamento. A predefinição é None.
Devoluções
O elemento único 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 do que um elemento.
Aplica-se a
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken)
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
- Origem:
- SingleAsync.cs
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a 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 Genérico
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
E IAsyncEnumerable<T> para devolver um único elemento de.
- defaultValue
- TSource
O valor padrão a devolver se a sequência estiver vazia.
- cancellationToken
- CancellationToken
O CancellationToken para monitorizar pedidos de cancelamento. A predefinição é None.
Devoluções
O único elemento da sequência de entrada que satisfaz a condição, ou defaultValue se tal elemento não for encontrado.
Exceções
predicate é null.
Mais do que 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
Devolve o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se tal elemento não existir; este método lança uma exceção se mais do que um elemento satisfizerem a 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 Genérico
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IAsyncEnumerable<TSource>
E IAsyncEnumerable<T> para devolver um único elemento de.
- predicate
- Func<TSource,CancellationToken,ValueTask<Boolean>>
Uma função para testar um elemento para uma condição.
- defaultValue
- TSource
O valor padrão a devolver se a sequência estiver vazia.
- cancellationToken
- CancellationToken
O CancellationToken para monitorizar pedidos de cancelamento. A predefinição é None.
Devoluções
O único elemento da sequência de entrada que satisfaz a condição, ou defaultValue se tal elemento não for encontrado.
Exceções
predicate é null.
Mais do que um elemento satisfaz a condição em predicate.