WebClient.UploadValues 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.
Charge une collection nom/valeur dans une ressource avec l’URI spécifié.
Surcharges
UploadValues(String, NameValueCollection) |
Charge la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié. |
UploadValues(Uri, NameValueCollection) |
Charge la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié. |
UploadValues(String, String, NameValueCollection) |
Charge 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. |
UploadValues(Uri, String, NameValueCollection) |
Charge 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. |
UploadValues(String, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Charge la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié.
public:
cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (string address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As String, data As NameValueCollection) As Byte()
Paramètres
- address
- String
URI de la ressource à recevoir.
- data
- NameValueCollection
Le NameValueCollection à envoyer à la ressource.
Retours
Tableau Byte contenant le corps de la réponse de la ressource.
Exceptions
L’URI formé en combinant BaseAddresset address
n’est pas valide.
-ou-
data
est null
.
-ou-
Il n’y a pas eu de réponse du serveur hébergeant la ressource.
-ou-
Une erreur s’est produite lors de l’ouverture du flux.
-ou-
L’en-tête Content-type
n’est pas null
ou « application/x-www-form-urlencoded ».
Exemples
L’exemple de code suivant collecte des informations à partir de l’utilisateur (nom, âge et adresse) et publie les valeurs sur le serveur à l’aide de UploadValues. Toute réponse du serveur s’affiche sur la console.
Console::Write( "\nPlease enter the URI to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;
Console::WriteLine( "Please enter the following parameters to be posted to the URL" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();
Console::Write( "Age: " );
String^ age = Console::ReadLine();
Console::Write( "Address: " );
String^ address = Console::ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );
// 'The Upload(String, NameValueCollection)' implicitly method sets HTTP POST as the request method.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, myNameValueCollection );
// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {0}", Encoding::ASCII->GetString( responseArray ) );
Console.Write("\nPlease enter the URI to post data to : ");
string uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();
Console.WriteLine("Please enter the following parameters to be posted to the URL");
Console.Write("Name:");
string name = Console.ReadLine();
Console.Write("Age:");
string age = Console.ReadLine();
Console.Write("Address:");
string address = Console.ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...", uriString);
// 'The Upload(String,NameValueCollection)' implicitly method sets HTTP POST as the request method.
byte[] responseArray = myWebClient.UploadValues(uriString,myNameValueCollection);
// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{0}",Encoding.ASCII.GetString(responseArray));
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the URL:")
Console.Write("Name:")
Dim name As String = Console.ReadLine()
Console.Write("Age:")
Dim age As String = Console.ReadLine()
Console.Write("Address:")
Dim address As String = Console.ReadLine()
' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)
Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' The Upload(String,NameValueCollection)' method implicitly sets the HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, myNameValueCollection)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{0}", Encoding.ASCII.GetString(responseArray))
Remarques
Prudence
WebRequest
, HttpWebRequest
, ServicePoint
et WebClient
sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
La méthode UploadValues envoie un NameValueCollection à un serveur. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadValuesAsync.
Si la demande sous-jacente 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.
Si l’en-tête content-type est null
, la méthode UploadValues la définit sur « application/x-www-form-urlencoded ».
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.
S’applique à
UploadValues(Uri, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Charge la collection nom/valeur spécifiée dans la ressource identifiée par l’URI spécifié.
public:
cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : Uri * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As Uri, data As NameValueCollection) As Byte()
Paramètres
- address
- Uri
URI de la ressource à recevoir.
- data
- NameValueCollection
Le NameValueCollection à envoyer à la ressource.
Retours
Tableau Byte contenant le corps de la réponse de la ressource.
Exceptions
L’URI formé en combinant BaseAddresset address
n’est pas valide.
-ou-
data
est null
.
-ou-
Il n’y a pas eu de réponse du serveur hébergeant la ressource.
-ou-
Une erreur s’est produite lors de l’ouverture du flux.
-ou-
L’en-tête Content-type
n’est pas null
ou « application/x-www-form-urlencoded ».
Remarques
Prudence
WebRequest
, HttpWebRequest
, ServicePoint
et WebClient
sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
La méthode UploadValues envoie un NameValueCollection à un serveur. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadValuesAsync.
Si la demande sous-jacente 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.
Si l’en-tête content-type est null
, la méthode UploadValues la définit sur « application/x-www-form-urlencoded ».
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.
S’applique à
UploadValues(String, String, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Charge 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.
public:
cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (string address, string? method, System.Collections.Specialized.NameValueCollection data);
public byte[] UploadValues (string address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : string * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As String, method As String, data As NameValueCollection) As Byte()
Paramètres
- address
- String
URI de la ressource à recevoir.
- method
- String
Méthode HTTP utilisée pour envoyer le fichier à 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.
Retours
Tableau Byte contenant le corps de la réponse de la ressource.
Exceptions
L’URI formé en combinant BaseAddresset address
n’est pas valide.
-ou-
data
est null
.
-ou-
Une erreur s’est produite lors de l’ouverture du flux.
-ou-
Il n’y a pas eu de réponse du serveur hébergeant la ressource.
-ou-
La valeur d’en-tête Content-type
n’est pas null
et n’est pas application/x-www-form-urlencoded
.
Exemples
L’exemple de code suivant collecte des informations à partir de l’utilisateur (nom, âge et adresse) et publie les valeurs sur le serveur à l’aide de UploadValues. Toute réponse du serveur s’affiche sur la console.
Console::Write( "\nPlease enter the URL to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;
Console::WriteLine( "Please enter the following parameters to be posted to the URI" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();
Console::Write( "Age: " );
String^ age = Console::ReadLine();
Console::Write( "Address: " );
String^ address = Console::ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );
// Upload the NameValueCollection.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, "POST", myNameValueCollection );
// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {0}", Encoding::ASCII->GetString( responseArray ) );
Console.Write("\nPlease enter the URL to post data to : ");
string uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();
Console.WriteLine("Please enter the following parameters to be posted to the URI");
Console.Write("Name:");
string name = Console.ReadLine();
Console.Write("Age:");
string age = Console.ReadLine();
Console.Write("Address:");
string address = Console.ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...", uriString);
// Upload the NameValueCollection.
byte[] responseArray = myWebClient.UploadValues(uriString,"POST",myNameValueCollection);
// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{0}",Encoding.ASCII.GetString(responseArray));
Console.Write(ControlChars.Cr + "Please enter the URL to post data to : ")
Dim uriString As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the Url")
Console.Write("Name:")
Dim name As String = Console.ReadLine()
Console.Write("Age:")
Dim age As String = Console.ReadLine()
Console.Write("Address:")
Dim address As String = Console.ReadLine()
' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)
Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' Upload the NameValueCollection.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, "POST", myNameValueCollection)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{0}", Encoding.ASCII.GetString(responseArray))
Remarques
Prudence
WebRequest
, HttpWebRequest
, ServicePoint
et WebClient
sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
La méthode UploadValues envoie une NameValueCollection à une ressource à l’aide de la méthode spécifiée dans le paramètre method
et retourne toute réponse du serveur. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadValuesAsync.
Si l’en-tête Content-type
est null
, la méthode UploadValues la définit sur application/x-www-form-urlencoded
.
Si le paramètre method
spécifie un verbe qui n’est pas compris 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.
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
.
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.
S’applique à
UploadValues(Uri, String, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Charge 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.
public:
cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public byte[] UploadValues (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : Uri * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As Uri, method As String, data As NameValueCollection) As Byte()
Paramètres
- address
- Uri
URI de la ressource à recevoir.
- method
- String
Méthode HTTP utilisée pour envoyer le fichier à 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.
Retours
Tableau Byte contenant le corps de la réponse de la ressource.
Exceptions
L’URI formé en combinant BaseAddresset address
n’est pas valide.
-ou-
data
est null
.
-ou-
Une erreur s’est produite lors de l’ouverture du flux.
-ou-
Il n’y a pas eu de réponse du serveur hébergeant la ressource.
-ou-
La valeur d’en-tête Content-type
n’est pas null
et n’est pas application/x-www-form-urlencoded
.
Remarques
Prudence
WebRequest
, HttpWebRequest
, ServicePoint
et WebClient
sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
La méthode UploadValues envoie une NameValueCollection à une ressource à l’aide de la méthode spécifiée dans le paramètre method
et retourne toute réponse du serveur. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadValuesAsync.
Si l’en-tête Content-type
est null
, la méthode UploadValues la définit sur application/x-www-form-urlencoded
.
Si le paramètre method
spécifie un verbe qui n’est pas compris 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.
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
.
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.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour