Sdílet prostřednictvím

WebClient.UploadData Metoda

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.WebClient.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Nahraje do prostředku vyrovnávací paměť dat se zadaným identifikátorem URI.

Přetížení

UploadData(String, Byte[])

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI.
UploadData(Uri, Byte[])

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI.
UploadData(String, String, Byte[])

Nahraje vyrovnávací paměť dat do zadaného prostředku pomocí zadané metody.
UploadData(Uri, String, Byte[])

Nahraje vyrovnávací paměť dat do zadaného prostředku pomocí zadané metody.

UploadData(String, Byte[])

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem 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()

Parametry

address
String

Identifikátor URI prostředku pro příjem dat.

data
Byte[]

Vyrovnávací paměť dat, která se má odeslat do prostředku.

Návraty

Byte[]

Pole Byte obsahující tělo odpovědi z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

data je null.

-nebo-

Při odesílání dat došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Příklady

Následující příklad kódu převede řetězec zadaný z konzoly na pole Byte a publikuje pole na zadaný server pomocí UploadData. V konzole se zobrazí jakákoli odpověď ze serveru.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda UploadData odešle do prostředku vyrovnávací paměť dat.

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se použije metoda POST. Pokud základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Metoda UploadData odešle obsah data na server bez kódování. Tato metoda blokuje při nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z metod UploadDataAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro

UploadData(Uri, Byte[])

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem 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()

Parametry

address
Uri

Identifikátor URI prostředku pro příjem dat.

data
Byte[]

Vyrovnávací paměť dat, která se má odeslat do prostředku.

Návraty

Byte[]

Pole Byte obsahující tělo odpovědi z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

data je null.

-nebo-

Při odesílání dat došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda UploadData odešle do prostředku vyrovnávací paměť dat.

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se použije metoda POST. Pokud základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Metoda UploadData odešle obsah data na server bez kódování. Tato metoda blokuje při nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z metod UploadDataAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro

UploadData(String, String, Byte[])

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Nahraje vyrovnávací paměť dat do zadaného prostředku pomocí zadané metody.

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

Parametry

address
String

Identifikátor URI prostředku pro příjem dat.

method
String

Metoda HTTP použitá k odeslání dat do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data
Byte[]

Vyrovnávací paměť dat, která se má odeslat do prostředku.

Návraty

Byte[]

Pole Byte obsahující tělo odpovědi z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

data je null.

-nebo-

Při nahrávání dat došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Příklady

Následující příklad kódu převede řetězec zadaný z konzoly na bajtové pole a publikuje pole na zadaný server pomocí UploadData. V konzole se zobrazí jakákoli odpověď ze serveru.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda UploadData odešle vyrovnávací paměť dat do prostředku pomocí metody HTTP zadané v parametru method a vrátí všechny odpovědi ze serveru. Tato metoda blokuje při nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z metod UploadDataAsync.

Metoda UploadData odešle obsah data na server bez kódování.

Pokud parametr method určuje operaci, která není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro

UploadData(Uri, String, Byte[])

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Nahraje vyrovnávací paměť dat do zadaného prostředku pomocí zadané metody.

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

Parametry

address
Uri

Identifikátor URI prostředku pro příjem dat.

method
String

Metoda HTTP použitá k odeslání dat do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data
Byte[]

Vyrovnávací paměť dat, která se má odeslat do prostředku.

Návraty

Byte[]

Pole Byte obsahující tělo odpovědi z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

data je null.

-nebo-

Při nahrávání dat došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda UploadData odešle vyrovnávací paměť dat do prostředku pomocí metody HTTP zadané v parametru method a vrátí všechny odpovědi ze serveru. Tato metoda blokuje při nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z metod UploadDataAsync.

Metoda UploadData odešle obsah data na server bez kódování.

Pokud parametr method určuje operaci, která není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro