DbCommand.ExecuteScalarAsync 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.
Implementa a versão assíncrona de ExecuteScalar(), mas devolve um Task síncrono, bloqueando o thread que chama.
Sobrecargas
| Name | Description |
|---|---|
| ExecuteScalarAsync() |
Uma versão assíncrona de ExecuteScalar(), que executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados. Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None. |
| ExecuteScalarAsync(CancellationToken) |
Esta é a versão assíncrona de ExecuteScalar(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado. A implementação padrão invoca o método síncrono ExecuteScalar() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteScalar serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do |
Observações
Para mais informações sobre programação assíncrona, veja Programação Assíncrona.
ExecuteScalarAsync()
Uma versão assíncrona de ExecuteScalar(), que executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None.
public:
System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();public System.Threading.Tasks.Task<object> ExecuteScalarAsync();member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync () As Task(Of Object)Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Ocorreu um erro durante a execução do comando.
Observações
Para mais informações sobre programação assíncrona, veja Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ExecuteScalar().
Ver também
Aplica-se a
ExecuteScalarAsync(CancellationToken)
Esta é a versão assíncrona de ExecuteScalar(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado.
A implementação padrão invoca o método síncrono ExecuteScalar() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteScalar serão comunicadas através da propriedade de Exceção de Tarefa devolvida.
Não invoque outros métodos e propriedades do DbCommand objeto até que a tarefa devolvida esteja concluída.
public:
virtual System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<object> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)Parâmetros
- cancellationToken
- CancellationToken
Um token para cancelar a operação assíncrona.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Ocorreu um erro durante a execução do comando.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona, veja Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ExecuteScalar().