Condividi tramite

WebClient.UploadData Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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[])

Carica un buffer di dati nella risorsa specificata usando il metodo specificato.
UploadData(Uri, String, Byte[])

Carica un buffer di dati nella risorsa specificata usando il metodo specificato.

UploadData(String, Byte[])

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
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

URI della risorsa per ricevere i dati.

data
Byte[]

Buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

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

-o-

data è null.

-o-

Errore durante l'invio dei dati.

-o-

Non è stata ricevuta alcuna 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.

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

Cautela

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

Il metodo UploadData 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 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.

Il metodo UploadData invia il contenuto di data al server senza codificarlo. 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 UploadDataAsync.

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.

Si applica a

UploadData(Uri, Byte[])

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
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

URI della risorsa per ricevere i dati.

data
Byte[]

Buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

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

-o-

data è null.

-o-

Errore durante l'invio dei dati.

-o-

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

Commenti

Cautela

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

Il metodo UploadData 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 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.

Il metodo UploadData invia il contenuto di data al server senza codificarlo. 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 UploadDataAsync.

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.

Si applica a

UploadData(String, String, Byte[])

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
WebClient.cs

Carica un buffer di dati nella risorsa specificata usando 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

URI della risorsa per ricevere i dati.

method
String

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

data
Byte[]

Buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

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

-o-

data è null.

-o-

Errore durante il caricamento dei dati.

-o-

Non è stata ricevuta alcuna 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

Cautela

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

Il metodo UploadData invia un buffer di dati a una risorsa usando il metodo HTTP 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 UploadDataAsync.

Il metodo UploadData invia il contenuto di data al server senza codificarlo.

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.

Si applica a

UploadData(Uri, String, Byte[])

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
WebClient.cs

Carica un buffer di dati nella risorsa specificata usando 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

URI della risorsa per ricevere i dati.

method
String

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

data
Byte[]

Buffer di dati da inviare alla risorsa.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

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

-o-

data è null.

-o-

Errore durante il caricamento dei dati.

-o-

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

Commenti

Cautela

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

Il metodo UploadData invia un buffer di dati a una risorsa usando il metodo HTTP 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 UploadDataAsync.

Il metodo UploadData invia il contenuto di data al server senza codificarlo.

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.

Si applica a