WebClient.UploadValuesAsync Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Transfère la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié. Ces méthodes ne bloquent pas le thread appelant.

Surcharges

UploadValuesAsync(Uri, NameValueCollection)	Transfère les données de la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié. Cette méthode ne bloque pas le thread appelant.
UploadValuesAsync(Uri, String, NameValueCollection)	Transfère les données de la collection nom/valeur spécifiée à 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)	Transfère les données de la collection nom/valeur spécifiée à 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 qui est appelée lorsque l'opération se termine.

UploadValuesAsync(Uri, NameValueCollection)

Source:

WebClient.cs

Transfère les données de la collection nom/valeur spécifiée à 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 devant recevoir la collection. Cet URI doit identifier une ressource capable d'accepter une demande envoyée à l'aide de la méthode par défaut.

data

NameValueCollection

NameValueCollection à envoyer à la ressource.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

- ou -

Le paramètre data a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.

- ou -

Il n'y avait pas de réponse du serveur hébergeant la ressource.

Remarques

Cette méthode envoie une chaîne à une ressource. La chaîne est envoyée de manière 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 Encoding propriété . Pour recevoir une notification lorsque le chargement de chaîne se termine, 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 bloquer en attendant la réponse du serveur, utilisez l’une UploadString des méthodes .

Dans .NET Framework et .NET Core 1.0, vous pouvez annuler les opérations asynchrones qui ne se sont pas terminées en appelant la CancelAsync méthode .

Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address ne contient pas d’URI absolu, address il doit s’agir d’un URI relatif combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété 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.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage 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 de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par UploadValues(Uri, NameValueCollection).

UploadValuesAsync(Uri, String, NameValueCollection)

Source:

WebClient.cs

Transfère les données de la collection nom/valeur spécifiée à 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 devant recevoir la collection. Cet URI doit identifier une ressource capable d'accepter une demande envoyée à l'aide de 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

NameValueCollection à envoyer à la ressource.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

- ou -

Le paramètre data a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.

- ou -

Il n'y avait pas de réponse du serveur hébergeant la ressource.

- ou -

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

Remarques

Cette méthode envoie les données contenues dans un NameValueCollection à la address ressource. Utilisez cette méthode pour envoyer des données de formulaire à un URI à des fins de traitement. Les données sont envoyées à l’aide du type de média form-urlencoded ; la valeur de l’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 UploadValuesAsync méthodes lèvent un WebException si vous appelez cette méthode avec une autre valeur d’en-tête Content-Type définie dans la Headers collection.

Si la method méthode 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, un WebException est levée avec la Status propriété 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 à la fin de l’opération de chargement, 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 bloquer en attendant la réponse du serveur, utilisez l’une UploadValues des méthodes .

Dans .NET Framework et .NET Core 1.0, vous pouvez annuler les opérations asynchrones qui ne se sont pas terminées en appelant la CancelAsync méthode .

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

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage 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 de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par UploadValues(Uri, String, NameValueCollection).

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Source:

WebClient.cs

Transfère les données de la collection nom/valeur spécifiée à 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 qui est appelée lorsque l'opération se termine.

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 devant recevoir la collection. Cet URI doit identifier une ressource capable d'accepter une demande envoyée à l'aide de 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

NameValueCollection à envoyer à la ressource.

userToken

Object

Objet défini par l'utilisateur, passé à la fin de l'opération asynchrone à la méthode appelée.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

- ou -

Le paramètre data a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.

- ou -

Il n'y avait pas de réponse du serveur hébergeant la ressource.

- ou -

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

Remarques

Cette méthode envoie les données contenues dans un NameValueCollection à la address ressource. Utilisez cette méthode pour envoyer des données de formulaire à un URI à des fins de traitement. Les données sont envoyées à l’aide du type de média form-urlencoded ; La valeur de l’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 UploadValuesAsync méthodes lèvent un WebException si vous appelez cette méthode avec une autre valeur d’en-tête Content-Type définie dans la Headers collection.

Si la method méthode 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, un WebException est levée avec la Status propriété 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 se termine, 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 bloquer en attendant la réponse du serveur, utilisez l’une UploadValues des méthodes .

Dans .NET Framework et .NET Core 1.0, vous pouvez annuler les opérations asynchrones qui ne se sont pas terminées en appelant la CancelAsync méthode .

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

Notes

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