HttpClient.DeleteAsync Método

Definição

Espaço de Nomes:: System.Net.Http

Assemblagem:: System.Net.Http.dll

Assemblagem:: netstandard.dll

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.

Enviar um pedido DELETE para o URI especificado como uma operação assíncrona.

Sobrecargas

Name	Description
DeleteAsync(String)	Enviar um pedido DELETE para o URI especificado como uma operação assíncrona.
DeleteAsync(Uri)	Enviar um pedido DELETE para o URI especificado como uma operação assíncrona.
DeleteAsync(String, CancellationToken)	Enviar um pedido DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona.
DeleteAsync(Uri, CancellationToken)	Enviar um pedido DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona.

DeleteAsync(String)

Enviar um pedido DELETE para o URI especificado como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync(string requestUri);

member this.DeleteAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As String) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: String

O URI para onde o pedido é enviado.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

-ou-

Não requestUri é um URI absoluto.

-ou-

BaseAddress não está definido.

HttpRequestException

O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Nas versões .NET 8 e posteriores, a razão é indicada por HttpRequestError.

-ou-

Framework .NET apenas: O pedido expirou.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

No caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET:

OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.

Aplica-se a

DeleteAsync(Uri)

Enviar um pedido DELETE para o URI especificado como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync(Uri requestUri);

member this.DeleteAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: Uri

O URI para onde o pedido é enviado.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

-ou-

Não requestUri é um URI absoluto.

-ou-

BaseAddress não está definido.

HttpRequestException

O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

No caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET:

OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.

Aplica-se a

DeleteAsync(String, CancellationToken)

Enviar um pedido DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync(string requestUri, System.Threading.CancellationToken cancellationToken);

member this.DeleteAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: String

O URI para onde o pedido é enviado.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

-ou-

Não requestUri é um URI absoluto.

-ou-

BaseAddress não está definido.

HttpRequestException

O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.

Aplica-se a

DeleteAsync(Uri, CancellationToken)

Enviar um pedido DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);

member this.DeleteAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: Uri

O URI para onde o pedido é enviado.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

-ou-

Não requestUri é um URI absoluto.

-ou-

BaseAddress não está definido.

HttpRequestException

O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.

OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.

OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

Comentários

Esta página foi útil?