Esporta (0) Stampa
Espandi tutto

Metodo WebClient.UploadData (String, Byte[])

Carica un buffer di dati in una risorsa identificata da un URI.

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

public byte[] UploadData (
	string address,
	byte[] data
)
public byte[] UploadData (
	String address, 
	byte[] data
)
public function UploadData (
	address : String, 
	data : byte[]
) : byte[]
Non applicabile.

Parametri

address

L'URI della risorsa per ricevere i dati.

data

Il buffer di dati da inviare alla risorsa.

Valore restituito

Matrice Byte contenente il corpo della risposta dalla risorsa.

Tipo di eccezioneCondizione

WebException

L'URI composto dalla combinazione di BaseAddress e address non è valido.

-oppure-

data è riferimento null (Nothing in Visual Basic).

-oppure-

Si è verificato un errore durante l'invio dei dati.

-oppure-

Nessuna risposta dal server in cui è presente la risorsa.

Il metodo UploadData invia un buffer di dati a una risorsa.

Questo metodo utilizza il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP viene utilizzato il metodo POST. Se la richiesta sottostante non viene accettata dal server, le classi del protocollo sottostanti determinano quello che si verifica. Nella maggior parte dei casi, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Il metodo UploadData invia al server il contenuto di data senza alcuna codifica. Questo metodo effettua il blocco durante l'upload dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, utilizzare uno dei metodi UploadDataAsync.

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

NotaNota:

Questo membro genera informazioni di analisi quando nell'applicazione viene attivata l'analisi della rete. Per ulteriori informazioni, vedere Analisi di rete.

Nell'esempio di codice riportato di seguito viene convertita una stringa immessa dalla console in una matrice Byte e viene inviata al server specificato utilizzando il metodo UploadData. Ogni risposta proveniente dal server viene visualizzata sulla console.

   Console.Write("\nPlease enter the URI to post data to : ");
   string uriString = Console.ReadLine();
   // Create a new WebClient instance.
   WebClient myWebClient = new WebClient();
   Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
   string postData = Console.ReadLine();
   // Apply ASCII Encoding to obtain the string as a byte array.
   byte[] postArray = Encoding.ASCII.GetBytes(postData);
   Console.WriteLine("Uploading to {0} ...",  uriString);                            
myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");
        
   //UploadData implicitly sets HTTP POST as the request method.
   byte[] responseArray = myWebClient.UploadData(uriString,postArray);

   // Decode and display the response.
   Console.WriteLine("\nResponse received was :{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();
Console.WriteLine("\nPlease enter the data to be posted to the" 
    + " URI {0}:", uriString);
String postData = Console.ReadLine();
// Apply ASCII Encoding to obtain the string as a byte array.
ubyte postArray[] = Encoding.get_ASCII().GetBytes(postData);
Console.WriteLine("Uploading to {0} ...", uriString);
myWebClient.get_Headers().Add("Content-Type",
    "application/x-www-form-urlencoded");
//UploadData implicitly sets HTTP POST as the request method.
ubyte responseArray[] = myWebClient.UploadData(uriString,
    postArray);
// Decode and display the response.
Console.WriteLine("\nResponse received was :{0}", Encoding.
    get_ASCII().GetString(responseArray));

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft