Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo WebClient.UploadValues (String, NameValueCollection)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

public byte[] UploadValues(
	string address,
	NameValueCollection data
)

Parametri

address
Type: System.String

L'URI della risorsa per ricevere la raccolta.

data
Type: System.Collections.Specialized.NameValueCollection

Il NameValueCollection inviare alla risorsa.

Valore restituito

Type: System.Byte[]

Oggetto Byte matrice contenente il corpo della risposta dalla risorsa.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

-oppure-

Il valore del parametro data è null.

WebException

L'URI formato dalla combinazione BaseAddress, e address non è valido.

-oppure-

data è null.

-oppure-

Si è verificato alcuna risposta dal server che ospita la risorsa.

-oppure-

Si è verificato un errore durante l'apertura del flusso.

-oppure-

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

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

Se la richiesta sottostante non è accettata dal server, le classi del protocollo sottostante determineranno le conseguenze. In genere, un WebException viene generata un'eccezione con il Status impostata per indicare l'errore.

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

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

Questo metodo utilizza il comando Archivia per caricare una risorsa FTP. Per una risorsa HTTP viene utilizzato il metodo POST.

System_CAPS_noteNota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Tracciatura di rete in .NET Framework.

Esempio di codice seguente consente di raccogliere informazioni dall'utente (nome, età e indirizzo) e inviati al server utilizzando i valori UploadValues. Ogni 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 = 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));

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: