WebClient.UploadValues Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Carica una raccolta nome/valore in una risorsa con l'URI specificato.

Overload

UploadValues(String, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato.
UploadValues(Uri, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato.
UploadValues(String, String, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato, usando il metodo specificato.
UploadValues(Uri, String, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato, usando il metodo specificato.

UploadValues(String, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato.

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

Parametri

address

String

URI della risorsa da ricevere la raccolta.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

data è null.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Errore durante l'apertura del flusso.

-o-

L'intestazione Content-type non è null o "application/x-www-form-urlencoded".

Esempio

L'esempio di codice seguente raccoglie informazioni dall'utente (nome, età e indirizzo) e inserisce i valori nel server usando UploadValues. Qualsiasi risposta dal server viene visualizzata nella 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))

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo UploadValues invia un NameValueCollection a un server. Questo metodo si blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, utilizzare uno dei metodi di UploadValuesAsync.

Se la richiesta sottostante non viene riconosciuta dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se l'intestazione Content-type è null, il metodo UploadValues lo imposta su "application/x-www-form-urlencoded".

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

UploadValues(Uri, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato.

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

Parametri

address

Uri

URI della risorsa da ricevere la raccolta.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

data è null.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Errore durante l'apertura del flusso.

-o-

L'intestazione Content-type non è null o "application/x-www-form-urlencoded".

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo UploadValues invia un NameValueCollection a un server. Questo metodo si blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, utilizzare uno dei metodi di UploadValuesAsync.

Se la richiesta sottostante non viene riconosciuta dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se l'intestazione Content-type è null, il metodo UploadValues lo imposta su "application/x-www-form-urlencoded".

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

UploadValues(String, String, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato, usando il metodo specificato.

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

member this.UploadValues : string * string * System.Collections.Specialized.NameValueCollection -> byte[]

Public Function UploadValues (address As String, method As String, data As NameValueCollection) As Byte()

Parametri

address

String

URI della risorsa da ricevere la raccolta.

method

String

Metodo HTTP usato per inviare il file alla risorsa. Se null, il valore predefinito è POST per http e STOR per ftp.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

data è null.

-o-

Errore durante l'apertura del flusso.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Il valore dell'intestazione Content-type non è null e non è application/x-www-form-urlencoded.

Esempio

L'esempio di codice seguente raccoglie informazioni dall'utente (nome, età e indirizzo) e inserisce i valori nel server usando UploadValues. Qualsiasi risposta dal server viene visualizzata nella 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))

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo UploadValues invia un NameValueCollection a una risorsa usando il metodo specificato nel parametro method e restituisce qualsiasi risposta dal server. Questo metodo si blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, utilizzare uno dei metodi di UploadValuesAsync.

Se l'intestazione Content-type è null, il metodo UploadValues lo imposta su application/x-www-form-urlencoded.

Se il parametro method specifica un verbo non compreso dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

UploadValues(Uri, String, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato, usando il metodo specificato.

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

member this.UploadValues : Uri * string * System.Collections.Specialized.NameValueCollection -> byte[]

Public Function UploadValues (address As Uri, method As String, data As NameValueCollection) As Byte()

Parametri

address

Uri

URI della risorsa da ricevere la raccolta.

method

String

Metodo HTTP usato per inviare il file alla risorsa. Se null, il valore predefinito è POST per http e STOR per ftp.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

data è null.

-o-

Errore durante l'apertura del flusso.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Il valore dell'intestazione Content-type non è null e non è application/x-www-form-urlencoded.

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo UploadValues invia un NameValueCollection a una risorsa usando il metodo specificato nel parametro method e restituisce qualsiasi risposta dal server. Questo metodo si blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, utilizzare uno dei metodi di UploadValuesAsync.

Se l'intestazione Content-type è null, il metodo UploadValues lo imposta su application/x-www-form-urlencoded.

Se il parametro method specifica un verbo non compreso dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.