WebClient.UploadValues 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í.
Nahraje kolekci názvů a hodnot do prostředku se zadaným identifikátorem URI.
Přetížení
UploadValues(String, NameValueCollection) |
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI. |
UploadValues(Uri, NameValueCollection) |
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI. |
UploadValues(String, String, NameValueCollection) |
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody. |
UploadValues(Uri, String, NameValueCollection) |
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody. |
UploadValues(String, NameValueCollection)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI.
public:
cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (string address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As String, data As NameValueCollection) As Byte()
Parametry
- address
- String
Identifikátor URI prostředku, který má kolekci přijmout.
- data
- NameValueCollection
Odešle NameValueCollection se do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddressaddress
a je neplatný.
-nebo-
data
je null
.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
-nebo-
Při otevírání datového proudu došlo k chybě.
-nebo-
Hlavička Content-type
není null
nebo "application/x-www-form-urlencoded".
Příklady
Následující příklad kódu shromáždí informace od uživatele (jméno, věk a adresu) a odešle hodnoty na server pomocí UploadValues. 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;
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;
Console::WriteLine( "Please enter the following parameters to be posted to the URL" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();
Console::Write( "Age: " );
String^ age = Console::ReadLine();
Console::Write( "Address: " );
String^ address = Console::ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );
// 'The Upload(String, NameValueCollection)' implicitly method sets HTTP POST as the request method.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, myNameValueCollection );
// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {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();
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();
Console.WriteLine("Please enter the following parameters to be posted to the URL");
Console.Write("Name:");
string name = Console.ReadLine();
Console.Write("Age:");
string age = Console.ReadLine();
Console.Write("Address:");
string address = Console.ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...", uriString);
// 'The Upload(String,NameValueCollection)' implicitly method sets HTTP POST as the request method.
byte[] responseArray = myWebClient.UploadValues(uriString,myNameValueCollection);
// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{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()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the URL:")
Console.Write("Name:")
Dim name As String = Console.ReadLine()
Console.Write("Age:")
Dim age As String = Console.ReadLine()
Console.Write("Address:")
Dim address As String = Console.ReadLine()
' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)
Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' The Upload(String,NameValueCollection)' method implicitly sets the HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, myNameValueCollection)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{0}", Encoding.ASCII.GetString(responseArray))
Poznámky
Metoda UploadValues odešle NameValueCollection na server . 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 UploadValuesAsync metod .
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.
Pokud je null
hlavička Content-type , UploadValues metoda ji nastaví na "application/x-www-form-urlencoded".
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
.
Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se používá metoda POST.
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
UploadValues(Uri, NameValueCollection)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI.
public:
cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : Uri * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As Uri, data As NameValueCollection) As Byte()
Parametry
- address
- Uri
Identifikátor URI prostředku, který má kolekci přijmout.
- data
- NameValueCollection
Odešle NameValueCollection se do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddressaddress
a je neplatný.
-nebo-
data
je null
.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
-nebo-
Při otevírání datového proudu došlo k chybě.
-nebo-
Hlavička Content-type
není null
nebo "application/x-www-form-urlencoded".
Poznámky
Metoda UploadValues odešle NameValueCollection na server . 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 UploadValuesAsync metod .
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.
Pokud je null
hlavička Content-type , UploadValues metoda ji nastaví na "application/x-www-form-urlencoded".
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
.
Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se používá metoda POST.
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
UploadValues(String, String, NameValueCollection)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody.
public:
cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (string address, string? method, System.Collections.Specialized.NameValueCollection data);
public byte[] UploadValues (string address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : string * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As String, method As String, data As NameValueCollection) As Byte()
Parametry
- address
- String
Identifikátor URI prostředku, který má kolekci přijmout.
- method
- String
Metoda HTTP použitá k odeslání souboru do prostředku. Pokud null, výchozí hodnota je POST pro http a STOR pro ftp.
- data
- NameValueCollection
Odešle NameValueCollection se do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddressaddress
a je neplatný.
-nebo-
data
je null
.
-nebo-
Při otevírání datového proudu došlo k chybě.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
-nebo-
Hodnota hlavičky Content-type
není null
a není application/x-www-form-urlencoded
.
Příklady
Následující příklad kódu shromáždí informace od uživatele (jméno, věk a adresu) a odešle hodnoty na server pomocí UploadValues. Všechny odpovědi ze serveru se zobrazí v konzole nástroje .
Console::Write( "\nPlease enter the URL to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;
Console::WriteLine( "Please enter the following parameters to be posted to the URI" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();
Console::Write( "Age: " );
String^ age = Console::ReadLine();
Console::Write( "Address: " );
String^ address = Console::ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );
// Upload the NameValueCollection.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, "POST", myNameValueCollection );
// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {0}", Encoding::ASCII->GetString( responseArray ) );
Console.Write("\nPlease enter the URL to post data to : ");
string uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();
Console.WriteLine("Please enter the following parameters to be posted to the URI");
Console.Write("Name:");
string name = Console.ReadLine();
Console.Write("Age:");
string age = Console.ReadLine();
Console.Write("Address:");
string address = Console.ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...", uriString);
// Upload the NameValueCollection.
byte[] responseArray = myWebClient.UploadValues(uriString,"POST",myNameValueCollection);
// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{0}",Encoding.ASCII.GetString(responseArray));
Console.Write(ControlChars.Cr + "Please enter the URL to post data to : ")
Dim uriString As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the Url")
Console.Write("Name:")
Dim name As String = Console.ReadLine()
Console.Write("Age:")
Dim age As String = Console.ReadLine()
Console.Write("Address:")
Dim address As String = Console.ReadLine()
' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)
Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' Upload the NameValueCollection.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, "POST", myNameValueCollection)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{0}", Encoding.ASCII.GetString(responseArray))
Poznámky
Metoda UploadValues odešle do prostředku metodu zadanou NameValueCollection 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 UploadValuesAsync metod .
Pokud je hlavička Content-type
, UploadValues metoda ji nastaví na application/x-www-form-urlencoded
.null
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
UploadValues(Uri, String, NameValueCollection)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody.
public:
cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public byte[] UploadValues (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : Uri * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As Uri, method As String, data As NameValueCollection) As Byte()
Parametry
- address
- Uri
Identifikátor URI prostředku, který má kolekci přijmout.
- method
- String
Metoda HTTP použitá k odeslání souboru do prostředku. Pokud null, výchozí hodnota je POST pro http a STOR pro ftp.
- data
- NameValueCollection
Odešle NameValueCollection se do prostředku.
Návraty
Pole Byte obsahující tělo odpovědi z prostředku.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddressaddress
a je neplatný.
-nebo-
data
je null
.
-nebo-
Při otevírání datového proudu došlo k chybě.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
-nebo-
Hodnota hlavičky Content-type
není null
a není application/x-www-form-urlencoded
.
Poznámky
Metoda UploadValues odešle do prostředku metodu zadanou NameValueCollection 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 UploadValuesAsync metod .
Pokud je hlavička Content-type
, UploadValues metoda ji nastaví na application/x-www-form-urlencoded
.null
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