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, String, NameValueCollection)

 

Data di pubblicazione: novembre 2016

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

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

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

Parametri

address
Type: System.String

L'URI della risorsa per ricevere la raccolta.

method
Type: System.String

Il metodo HTTP utilizzato per inviare il file della risorsa. Se null, il valore predefinito è POST per http e la archivia per ftp.

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 un errore durante l'apertura del flusso.

-oppure-

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

-oppure-

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

Il UploadValues metodo invia un NameValueCollection a una risorsa utilizzando il metodo specificato nel method parametro e restituisce una risposta dal 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 il Content-type intestazione null, UploadValues metodo lo imposta su application/x-www-form-urlencoded.

Se il method parametro specifica un verbo non accettato 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 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.

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

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