WebClient.UploadValuesAsync Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Charge la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié. Ces méthodes ne bloquent pas le thread appelant.

Surcharges

UploadValuesAsync(Uri, NameValueCollection)	Charge les données dans la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié. Cette méthode ne bloque pas le thread appelant.
UploadValuesAsync(Uri, String, NameValueCollection)	Charge les données de la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié, à l’aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant.
UploadValuesAsync(Uri, String, NameValueCollection, Object)	Charge les données de la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié, à l’aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant et permet à l’appelant de passer un objet à la méthode appelée une fois l’opération terminée.

UploadValuesAsync(Uri, NameValueCollection)

Source:

WebClient.cs

Charge les données dans la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié. Cette méthode ne bloque pas le thread appelant.

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

Paramètres

address

Uri

URI de la ressource à recevoir. Cet URI doit identifier une ressource qui peut accepter une demande envoyée avec la méthode par défaut.

data

NameValueCollection

Le NameValueCollection à envoyer à la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre data est null.

WebException

L’URI formé en combinant BaseAddress et address n’est pas valide.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Cette méthode envoie une chaîne à une ressource. La chaîne est envoyée de façon asynchrone à l’aide de ressources de thread qui sont automatiquement allouées à partir du pool de threads. Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la propriété Encoding. Pour recevoir une notification lorsque le chargement de chaîne est terminé, vous pouvez ajouter un gestionnaire d’événements à l’événement UploadStringCompleted.

Cette méthode ne bloque pas le thread appelant pendant l’envoi de la chaîne. Pour envoyer une chaîne et un bloc en attendant la réponse du serveur, utilisez l’une des méthodes UploadString.

Dans .NET Framework et .NET Core 1.0, vous pouvez annuler les opérations asynchrones qui n’ont pas été effectuées en appelant la méthode CancelAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.

Cette méthode utilise la commande STOR pour charger une ressource FTP. Pour une ressource HTTP, la méthode POST est utilisée.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par UploadValues(Uri, NameValueCollection).

UploadValuesAsync(Uri, String, NameValueCollection)

Source:

WebClient.cs

Charge les données de la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié, à l’aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

Paramètres

address

Uri

URI de la ressource à recevoir. Cet URI doit identifier une ressource qui peut accepter une demande envoyée avec la méthode method.

method

String

Méthode utilisée pour envoyer la chaîne à la ressource. Si la valeur est Null, la valeur par défaut est POST pour http et STOR pour ftp.

data

NameValueCollection

Le NameValueCollection à envoyer à la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre data est null.

WebException

L’URI formé en combinant BaseAddress et address n’est pas valide.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

-ou-

method ne peut pas être utilisé pour envoyer du contenu.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Cette méthode envoie les données contenues dans un NameValueCollection à la ressource address. Utilisez cette méthode pour envoyer des données de formulaire à un URI pour le traitement. Les données sont envoyées à l’aide du type de média form-urlencoded ; La valeur d’en-tête Content-Type doit être définie sur « application/x-www-form-urlencoded ». L’en-tête est défini correctement par défaut. Les méthodes UploadValuesAsync lèvent une WebException si vous appelez cette méthode avec une autre valeur d’en-tête Content-Type définie dans la collection Headers.

Si la méthode method n’est pas comprise par le serveur, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.

Le NameValueCollection est envoyé de manière asynchrone à l’aide de ressources de thread qui sont automatiquement allouées à partir du pool de threads. Pour recevoir une notification lorsque l’opération de chargement est terminée, ajoutez un gestionnaire d’événements à l’événement UploadValuesCompleted.

Cette méthode ne bloque pas le thread appelant pendant l’envoi de la chaîne. Pour envoyer une chaîne et un bloc en attendant la réponse du serveur, utilisez l’une des méthodes UploadValues.

Dans .NET Framework et .NET Core 1.0, vous pouvez annuler les opérations asynchrones qui n’ont pas été effectuées en appelant la méthode CancelAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas vide, elle est ajoutée à address.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez suivi réseau dans .NET Framework.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par UploadValues(Uri, String, NameValueCollection).

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Source:

WebClient.cs

Charge les données de la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié, à l’aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant et permet à l’appelant de passer un objet à la méthode appelée une fois l’opération terminée.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);

public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

Paramètres

address

Uri

URI de la ressource à recevoir. Cet URI doit identifier une ressource qui peut accepter une demande envoyée avec la méthode method.

method

String

Méthode HTTP utilisée pour envoyer la chaîne à la ressource. Si la valeur est Null, la valeur par défaut est POST pour http et STOR pour ftp.

data

NameValueCollection

Le NameValueCollection à envoyer à la ressource.

userToken

Object

Objet défini par l’utilisateur passé à la méthode appelée lorsque l’opération asynchrone se termine.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre data est null.

WebException

L’URI formé en combinant BaseAddress et address n’est pas valide.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

-ou-

method ne peut pas être utilisé pour envoyer du contenu.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Cette méthode envoie les données contenues dans un NameValueCollection à la ressource address. Utilisez cette méthode pour envoyer des données de formulaire à un URI pour le traitement. Les données sont envoyées à l’aide du type de média form-urlencoded ; La valeur d’en-tête Content-Type doit être définie sur « application/x-www-form-urlencoded ». L’en-tête est défini correctement par défaut. Les méthodes UploadValuesAsync lèvent une WebException si vous appelez cette méthode avec une autre valeur d’en-tête Content-Type définie dans la collection Headers.

Si la méthode method n’est pas comprise par le serveur, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.

Le NameValueCollection est envoyé de manière asynchrone à l’aide de ressources de thread qui sont automatiquement allouées à partir du pool de threads. Pour recevoir une notification lorsque l’opération de chargement est terminée, ajoutez un gestionnaire d’événements à l’événement UploadValuesCompleted.

Cette méthode ne bloque pas le thread appelant pendant l’envoi de la chaîne. Pour envoyer une chaîne et un bloc en attendant la réponse du serveur, utilisez l’une des méthodes UploadValues.

Dans .NET Framework et .NET Core 1.0, vous pouvez annuler les opérations asynchrones qui n’ont pas été effectuées en appelant la méthode CancelAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas vide, elle est ajoutée à address.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez suivi réseau dans .NET Framework.