HttpClient.DeleteAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Envíe una solicitud DELETE al URI especificado como una operación asincrónica.
Sobrecargas
| Nombre | Description |
|---|---|
| DeleteAsync(String) |
Envíe una solicitud DELETE al URI especificado como una operación asincrónica. |
| DeleteAsync(Uri) |
Envíe una solicitud DELETE al URI especificado como una operación asincrónica. |
| DeleteAsync(String, CancellationToken) |
Envíe una solicitud DELETE al URI especificado con un token de cancelación como una operación asincrónica. |
| DeleteAsync(Uri, CancellationToken) |
Envíe una solicitud DELETE al URI especificado con un token de cancelación como una operación asincrónica. |
DeleteAsync(String)
Envíe una solicitud DELETE al URI especificado como una operación asincrónica.
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
Identificador URI al que se envía la solicitud.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
La instancia ya envió el mensaje de HttpClient solicitud.
O bien
no requestUri es un URI absoluto.
O bien
BaseAddress no está establecido.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError.
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes:
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
Se aplica a
DeleteAsync(Uri)
Envíe una solicitud DELETE al URI especificado como una operación asincrónica.
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
Identificador URI al que se envía la solicitud.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
La instancia ya envió el mensaje de HttpClient solicitud.
O bien
no requestUri es un URI absoluto.
O bien
BaseAddress no está establecido.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes:
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
Se aplica a
DeleteAsync(String, CancellationToken)
Envíe una solicitud DELETE al URI especificado con un token de cancelación como una operación asincrónica.
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
Identificador URI al que se envía la solicitud.
- cancellationToken
- CancellationToken
Token de cancelación que otros objetos o subprocesos pueden usar para recibir un aviso de cancelación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
La instancia ya envió el mensaje de HttpClient solicitud.
O bien
no requestUri es un URI absoluto.
O bien
BaseAddress no está establecido.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
O bien
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
Se aplica a
DeleteAsync(Uri, CancellationToken)
Envíe una solicitud DELETE al URI especificado con un token de cancelación como una operación asincrónica.
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
Identificador URI al que se envía la solicitud.
- cancellationToken
- CancellationToken
Token de cancelación que otros objetos o subprocesos pueden usar para recibir un aviso de cancelación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
La instancia ya envió el mensaje de HttpClient solicitud.
O bien
no requestUri es un URI absoluto.
O bien
BaseAddress no está establecido.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
O bien
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.