HttpClient.DeleteAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Envoyez une requête DELETE à l’URI spécifié en tant qu’opération asynchrone.
Surcharges
| Nom | Description |
|---|---|
| DeleteAsync(String) |
Envoyez une requête DELETE à l’URI spécifié en tant qu’opération asynchrone. |
| DeleteAsync(Uri) |
Envoyez une requête DELETE à l’URI spécifié en tant qu’opération asynchrone. |
| DeleteAsync(String, CancellationToken) |
Envoyez une requête DELETE à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone. |
| DeleteAsync(Uri, CancellationToken) |
Envoyez une requête DELETE à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone. |
DeleteAsync(String)
Envoyez une requête DELETE à l’URI spécifié en tant qu’opération asynchrone.
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)
Paramètres
- requestUri
- String
URI auquel la requête est envoyée.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
Le message de demande a déjà été envoyé par l’instance HttpClient .
-ou-
Ce requestUri n’est pas un URI absolu.
-ou-
BaseAddress n’est pas défini.
La requête a échoué en raison d’un problème d’obtention d’une réponse HTTP valide, telle que l’échec de connectivité réseau, l’échec DNS, l’erreur de validation du certificat de serveur ou la réponse du serveur non valide. Sur .NET 8 et versions ultérieures, la raison est indiquée par HttpRequestError.
-ou-
.NET Framework uniquement : la requête a expiré.
.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.
Note
En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations .NET :
- OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.
- OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
- HttpRequestException est levée sur toutes les versions .NET Framework applicables.
S’applique à
DeleteAsync(Uri)
Envoyez une requête DELETE à l’URI spécifié en tant qu’opération asynchrone.
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)
Paramètres
- requestUri
- Uri
URI auquel la requête est envoyée.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
Le message de demande a déjà été envoyé par l’instance HttpClient .
-ou-
Ce requestUri n’est pas un URI absolu.
-ou-
BaseAddress n’est pas défini.
La requête a échoué en raison d’un problème d’obtention d’une réponse HTTP valide, telle que l’échec de connectivité réseau, l’échec DNS, l’erreur de validation du certificat de serveur ou la réponse du serveur non valide. Sur .NET 8 et versions ultérieures, la raison est indiquée par HttpRequestError
-ou-
.NET Framework uniquement : la requête a expiré.
.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.
Note
En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations .NET :
- OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.
- OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
- HttpRequestException est levée sur toutes les versions .NET Framework applicables.
S’applique à
DeleteAsync(String, CancellationToken)
Envoyez une requête DELETE à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
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)
Paramètres
- requestUri
- String
URI auquel la requête est envoyée.
- cancellationToken
- CancellationToken
Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
Le message de demande a déjà été envoyé par l’instance HttpClient .
-ou-
Ce requestUri n’est pas un URI absolu.
-ou-
BaseAddress n’est pas défini.
La requête a échoué en raison d’un problème d’obtention d’une réponse HTTP valide, telle que l’échec de connectivité réseau, l’échec DNS, l’erreur de validation du certificat de serveur ou la réponse du serveur non valide. Sur .NET 8 et versions ultérieures, la raison est indiquée par HttpRequestError
-ou-
.NET Framework uniquement : la requête a expiré.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
-ou-
.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.
Note
En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations de .NET.
- OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.
- OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
- HttpRequestException est levée sur toutes les versions .NET Framework applicables.
S’applique à
DeleteAsync(Uri, CancellationToken)
Envoyez une requête DELETE à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
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)
Paramètres
- requestUri
- Uri
URI auquel la requête est envoyée.
- cancellationToken
- CancellationToken
Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
Le message de demande a déjà été envoyé par l’instance HttpClient .
-ou-
Ce requestUri n’est pas un URI absolu.
-ou-
BaseAddress n’est pas défini.
La requête a échoué en raison d’un problème d’obtention d’une réponse HTTP valide, telle que l’échec de connectivité réseau, l’échec DNS, l’erreur de validation du certificat de serveur ou la réponse du serveur non valide. Sur .NET 8 et versions ultérieures, la raison est indiquée par HttpRequestError
-ou-
.NET Framework uniquement : la requête a expiré.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
-ou-
.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.
Note
En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations de .NET.
- HttpRequestException est levée sur toutes les versions .NET Framework applicables.
- OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
- OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.