WebClient.UploadValuesAsync Méthode

Source:

WebClient.cs

Source:

WebClient.cs

Source:

WebClient.cs

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

Exceptions

Remarques

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.

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).

Source:

WebClient.cs

Source:

WebClient.cs

Source:

WebClient.cs

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);

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

Exceptions

Remarques

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.

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).

Source:

WebClient.cs

Source:

WebClient.cs

Source:

WebClient.cs

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);

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

Exceptions

Remarques

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.