WebClient.UploadData Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Odešle datovou vyrovnávací paměť do prostředku se zadaným identifikátorem URI.
Přetížení
UploadData(String, Byte[]) |
Nahraje datovou vyrovnávací paměť do prostředku identifikovaného identifikátorem URI. |
UploadData(Uri, Byte[]) |
Nahraje datovou vyrovnávací paměť do prostředku identifikovaného identifikátorem URI. |
UploadData(String, String, Byte[]) |
Odešle datovou vyrovnávací paměť do zadaného prostředku pomocí zadané metody. |
UploadData(Uri, String, Byte[]) |
Odešle datovou vyrovnávací paměť do zadaného prostředku pomocí zadané metody. |
UploadData(String, Byte[])
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje datovou vyrovnávací paměť 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[]
Datová vyrovnávací paměť, která se má odeslat do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a 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, nepřišla žádná odpověď.
Příklady
Následující příklad kódu převede řetězec zadaný z konzoly na Byte pole a odešle pole na zadaný server pomocí UploadData. Všechny odpovědi ze serveru se zobrazí v konzole nástroje .
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
Metoda UploadData odešle do prostředku datovou vyrovnávací paměť.
Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se používá metoda POST. Pokud server nerozumí podkladovému požadavku, určují, co se stane, třídy podkladových protokolů. Obvykle WebException je vyvolán s vlastností nastavenou Status k označení chyby.
Metoda UploadData odešle obsah data
na server bez kódování. Tato metoda blokuje nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z UploadDataAsync metod .
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete 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 datovou vyrovnávací paměť 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[]
Datová vyrovnávací paměť, která se má odeslat do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a 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, nepřišla žádná odpověď.
Poznámky
Metoda UploadData odešle do prostředku datovou vyrovnávací paměť.
Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se používá metoda POST. Pokud server nerozumí podkladovému požadavku, určují, co se stane, třídy podkladových protokolů. Obvykle WebException je vyvolán s vlastností nastavenou Status k označení chyby.
Metoda UploadData odešle obsah data
na server bez kódování. Tato metoda blokuje nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z UploadDataAsync metod .
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete 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
Odešle datovou vyrovnávací paměť 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 null, výchozí hodnota je POST pro http a STOR pro ftp.
- data
- Byte[]
Datová vyrovnávací paměť, která se má odeslat do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a 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, nepřišla žádná odpověď.
Příklady
Následující příklad kódu převede řetězec zadaný z konzoly na pole bajtů a odešle pole na zadaný server pomocí UploadData. Všechny odpovědi ze serveru se zobrazí v konzole nástroje .
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
Metoda UploadData odešle do prostředku vyrovnávací paměť dat pomocí metody HTTP zadané v parametru method
a vrátí všechny odpovědi ze serveru. Tato metoda blokuje nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z UploadDataAsync metod .
Metoda UploadData odešle obsah data
na server bez kódování.
method
Pokud parametr určuje sloveso, které není srozumitelné pro server, třídy podkladových protokolů určují, co se stane. Obvykle WebException je vyvolán s vlastností nastavenou Status k označení chyby.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete 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
Odešle datovou vyrovnávací paměť 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 null, výchozí hodnota je POST pro http a STOR pro ftp.
- data
- Byte[]
Datová vyrovnávací paměť, která se má odeslat do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a 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, nepřišla žádná odpověď.
Poznámky
Metoda UploadData odešle do prostředku vyrovnávací paměť dat pomocí metody HTTP zadané v parametru method
a vrátí všechny odpovědi ze serveru. Tato metoda blokuje nahrávání dat. Pokud chcete pokračovat v provádění při čekání na odpověď serveru, použijte jednu z UploadDataAsync metod .
Metoda UploadData odešle obsah data
na server bez kódování.
method
Pokud parametr určuje sloveso, které není srozumitelné pro server, třídy podkladových protokolů určují, co se stane. Obvykle WebException je vyvolán s vlastností nastavenou Status k označení chyby.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro