HttpClient.DeleteAsync 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.
Envie uma solicitação DELETE para o URI especificado como uma operação assíncrona.
Sobrecargas
| Nome | Description |
|---|---|
| DeleteAsync(String) |
Envie uma solicitação DELETE para o URI especificado como uma operação assíncrona. |
| DeleteAsync(Uri) |
Envie uma solicitação DELETE para o URI especificado como uma operação assíncrona. |
| DeleteAsync(String, CancellationToken) |
Envie uma solicitação DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona. |
| DeleteAsync(Uri, CancellationToken) |
Envie uma solicitação DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona. |
DeleteAsync(String)
Envie uma solicitação 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 o qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
A mensagem de solicitação já foi enviada pela HttpClient instância.
-ou-
O requestUri URI não é absoluto.
-ou-
BaseAddress não está definido.
A solicitação falhou devido a um problema ao obter uma resposta HTTP válida, como falha de conectividade de rede, falha de DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em .NET 8 e versões posteriores, o motivo é indicado por HttpRequestError.
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Note
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET:
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
Aplica-se a
DeleteAsync(Uri)
Envie uma solicitação 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 o qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
A mensagem de solicitação já foi enviada pela HttpClient instância.
-ou-
O requestUri URI não é absoluto.
-ou-
BaseAddress não está definido.
A solicitação falhou devido a um problema ao obter uma resposta HTTP válida, como falha de conectividade de rede, falha de DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Note
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET:
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
Aplica-se a
DeleteAsync(String, CancellationToken)
Envie uma solicitação 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 o qual a solicitação é enviada.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
A mensagem de solicitação já foi enviada pela HttpClient instância.
-ou-
O requestUri URI não é absoluto.
-ou-
BaseAddress não está definido.
A solicitação falhou devido a um problema ao obter uma resposta HTTP válida, como falha de conectividade de rede, falha de DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
-ou-
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
Aplica-se a
DeleteAsync(Uri, CancellationToken)
Envie uma solicitação 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 o qual a solicitação é enviada.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
A mensagem de solicitação já foi enviada pela HttpClient instância.
-ou-
O requestUri URI não é absoluto.
-ou-
BaseAddress não está definido.
A solicitação falhou devido a um problema ao obter uma resposta HTTP válida, como falha de conectividade de rede, falha de DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
-ou-
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.