WebClient.UploadData Metodo

Definizione

Carica un buffer di dati in una risorsa con l'URI specificato.

Overload

UploadData(String, Byte[])

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

UploadData(Uri, Byte[])

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

UploadData(String, String, Byte[])

Esegue l'upload del buffer di dati nella risorsa specificata utilizzando il metodo specificato.

UploadData(Uri, String, Byte[])

Esegue l'upload del buffer di dati nella risorsa specificata utilizzando il metodo specificato.

UploadData(String, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

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

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData (string address, byte[] data);
member this.UploadData : string * byte[] -> byte[]
Public Function UploadData (address As String, data As Byte()) As Byte()

Parametri

address
String

L'URI della risorsa per ricevere i dati.

data
Byte[]

Il buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

Il valore del parametro address è null.

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

-oppure-

data è null.

-oppure-

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

-oppure-

Nessuna risposta dal server che ospita la risorsa.

Esempio

L'esempio di codice seguente converte una stringa immessa dalla console in una Byte matrice e inserisce la matrice nel server specificato usando UploadData. 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;
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.
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.
array<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.
    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(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()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII Encoding to obtain the string as a byte array.
Dim postArray As Byte() = 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.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, postArray)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

Commenti

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

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST. Se la richiesta sottostante non viene compresa dal server, le classi di protocollo sottostanti determinano ciò che si verifica. In genere, viene generato un WebException oggetto con la proprietà impostata per indicare l'errore Status .

Il UploadData metodo invia il contenuto del data server senza codificarlo. Questo metodo blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei UploadDataAsync metodi.

Se la BaseAddress proprietà 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 QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Nota

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

Si applica a

UploadData(Uri, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

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

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData (Uri address, byte[] data);
member this.UploadData : Uri * byte[] -> byte[]
Public Function UploadData (address As Uri, data As Byte()) As Byte()

Parametri

address
Uri

L'URI della risorsa per ricevere i dati.

data
Byte[]

Il buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

Il valore del parametro address è null.

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

-oppure-

data è null.

-oppure-

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

-oppure-

Nessuna risposta dal server che ospita la risorsa.

Commenti

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

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST. Se la richiesta sottostante non viene compresa dal server, le classi di protocollo sottostanti determinano ciò che si verifica. In genere, viene generato un WebException oggetto con la proprietà impostata per indicare l'errore Status .

Il UploadData metodo invia il contenuto del data server senza codificarlo. Questo metodo blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei UploadDataAsync metodi.

Se la BaseAddress proprietà 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 QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Nota

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

Si applica a

UploadData(String, String, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Esegue l'upload del buffer di dati nella risorsa specificata utilizzando il metodo specificato.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData (string address, string? method, byte[] data);
public byte[] UploadData (string address, string method, byte[] data);
member this.UploadData : string * string * byte[] -> byte[]
Public Function UploadData (address As String, method As String, data As Byte()) As Byte()

Parametri

address
String

L'URI della risorsa per ricevere i dati.

method
String

Il metodo HTTP utilizzato per inviare i dati alla risorsa. Se il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.

data
Byte[]

Il buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

Il valore del parametro address è null.

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

-oppure-

data è null.

-oppure-

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

-oppure-

Nessuna risposta dal server che ospita la risorsa.

Esempio

L'esempio di codice seguente converte una stringa immessa dalla console in una matrice di byte e inserisce la matrice nel server specificato usando UploadData. Qualsiasi risposta dal server viene visualizzata nella console.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to {for example, http://www.contoso.com}: " );
uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

// Displays the headers in the request
Console::Write( "Resulting Request Headers: ");
Console::WriteLine(myWebClient->Headers);

// Apply ASCII Encoding to obtain the String^ as a Byte array.
array<Byte>^ byteArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
// Upload the input String* using the HTTP 1.0 POST method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, "POST", byteArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was {0}",
   Encoding::ASCII->GetString( responseArray ) );
   string uriString;
       Console.Write("\nPlease enter the URI to post data to {for example, http://www.contoso.com} : ");
       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();
       myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

 // Display the headers in the request
       Console.Write("Resulting Request Headers: ");
       Console.WriteLine(myWebClient.Headers.ToString());
       
       // Apply ASCII Encoding to obtain the string as a byte array.

       byte[] byteArray = Encoding.ASCII.GetBytes(postData);
       Console.WriteLine("Uploading to {0} ...",  uriString);						
       // Upload the input string using the HTTP 1.0 POST method.
       byte[] responseArray = myWebClient.UploadData(uriString,"POST",byteArray);
       
       // Decode and display the response.
       Console.WriteLine("\nResponse received was {0}",
       Encoding.ASCII.GetString(responseArray));
                 
Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to{for example, http://www.contoso.com} : ")
uriString = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' Display the headers in the request
Console.Write("Resulting Request Headers: ")
Console.Writeline(myWebClient.Headers.ToString())

' Apply ASCII Encoding to obtain the string as a byte array.
Dim byteArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
' Upload the input string using the HTTP 1.0 POST method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, "POST", byteArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

Commenti

Il UploadData metodo invia un buffer di dati a una risorsa usando il metodo HTTP specificato nel method parametro e restituisce qualsiasi risposta dal server. Questo metodo blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei UploadDataAsync metodi.

Il UploadData metodo invia il contenuto del data server senza codificarlo.

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

Se la BaseAddress proprietà 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 QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Nota

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

Si applica a

UploadData(Uri, String, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Esegue l'upload del buffer di dati nella risorsa specificata utilizzando il metodo specificato.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData (Uri address, string? method, byte[] data);
public byte[] UploadData (Uri address, string method, byte[] data);
member this.UploadData : Uri * string * byte[] -> byte[]
Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()

Parametri

address
Uri

L'URI della risorsa per ricevere i dati.

method
String

Il metodo HTTP utilizzato per inviare i dati alla risorsa. Se il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.

data
Byte[]

Il buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

Il valore del parametro address è null.

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

-oppure-

data è null.

-oppure-

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

-oppure-

Nessuna risposta dal server che ospita la risorsa.

Commenti

Il UploadData metodo invia un buffer di dati a una risorsa usando il metodo HTTP specificato nel method parametro e restituisce qualsiasi risposta dal server. Questo metodo blocca durante il caricamento dei dati. Per continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei UploadDataAsync metodi.

Il UploadData metodo invia il contenuto del data server senza codificarlo.

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

Se la BaseAddress proprietà 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 QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Nota

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

Si applica a