WebClient.UploadValues Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Feltölt egy név-/értékgyűjteményt egy erőforrásba a megadott URI-val.
Túlterhelések
| Name | Description |
|---|---|
| UploadValues(String, NameValueCollection) |
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba. |
| UploadValues(Uri, NameValueCollection) |
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba. |
| UploadValues(String, String, NameValueCollection) |
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba a megadott módszerrel. |
| UploadValues(Uri, String, NameValueCollection) |
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba a megadott módszerrel. |
UploadValues(String, NameValueCollection)
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba.
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()Paraméterek
- address
- String
A gyűjtemény fogadásához tartozó erőforrás URI-ja.
- data
- NameValueCollection
Az NameValueCollection erőforrásnak küldendő.
Válaszok
Az Byte erőforrás válaszának törzsét tartalmazó tömb.
Kivételek
A address paraméter a következő null: .
-vagy-
A data paraméter a következő null: .
A kombinálással BaseAddressaddress létrehozott URI érvénytelen.
-vagy-
data az null.
-vagy-
Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.
-vagy-
Hiba történt a stream megnyitása közben.
-vagy-
A Content-type fejléc nem null vagy "application/x-www-form-urlencoded".
Példák
Az alábbi példakód adatokat gyűjt a felhasználótól (név, életkor és cím), és az értékeket a kiszolgálóra küldi a használatával UploadValues. A kiszolgáló válaszai megjelennek a konzolon.
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))
Megjegyzések
Figyelmeztetés
WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.
A UploadValues metódus egy kiszolgálónak küld egy NameValueCollection üzenetet. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadValuesAsync .
Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.
Ha a Tartalom típusú fejléc az null, a metódus az UploadValues "application/x-www-form-urlencoded" értékre állítja.
Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address
Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.
Note
Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.
A következőre érvényes:
UploadValues(Uri, NameValueCollection)
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba.
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()Paraméterek
- address
- Uri
A gyűjtemény fogadásához tartozó erőforrás URI-ja.
- data
- NameValueCollection
Az NameValueCollection erőforrásnak küldendő.
Válaszok
Az Byte erőforrás válaszának törzsét tartalmazó tömb.
Kivételek
A address paraméter a következő null: .
-vagy-
A data paraméter a következő null: .
A kombinálással BaseAddressaddress létrehozott URI érvénytelen.
-vagy-
data az null.
-vagy-
Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.
-vagy-
Hiba történt a stream megnyitása közben.
-vagy-
A Content-type fejléc nem null vagy "application/x-www-form-urlencoded".
Megjegyzések
Figyelmeztetés
WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.
A UploadValues metódus egy kiszolgálónak küld egy NameValueCollection üzenetet. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadValuesAsync .
Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.
Ha a Tartalom típusú fejléc az null, a metódus az UploadValues "application/x-www-form-urlencoded" értékre állítja.
Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address
Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.
Note
Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.
A következőre érvényes:
UploadValues(String, String, NameValueCollection)
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba a megadott módszerrel.
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()Paraméterek
- address
- String
A gyűjtemény fogadásához tartozó erőforrás URI-ja.
- method
- String
A fájl erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.
- data
- NameValueCollection
Az NameValueCollection erőforrásnak küldendő.
Válaszok
Az Byte erőforrás válaszának törzsét tartalmazó tömb.
Kivételek
A address paraméter a következő null: .
-vagy-
A data paraméter a következő null: .
A kombinálással BaseAddressaddress létrehozott URI érvénytelen.
-vagy-
data az null.
-vagy-
Hiba történt a stream megnyitása közben.
-vagy-
Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.
-vagy-
A Content-type fejléc értéke nem, és nem nullapplication/x-www-form-urlencodedis.
Példák
Az alábbi példakód adatokat gyűjt a felhasználótól (név, életkor és cím), és az értékeket a kiszolgálóra küldi a használatával UploadValues. A kiszolgáló válaszai megjelennek a konzolon.
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))
Megjegyzések
Figyelmeztetés
WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.
A UploadValues metódus a paraméterben NameValueCollection megadott metódus használatával küld egy method erőforrást egy erőforrásnak, és visszaadja a kiszolgáló válaszait. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadValuesAsync .
Ha a Content-type fejléc az null, akkor a metódus a UploadValues következőre application/x-www-form-urlencodedállítja: .
Ha a method paraméter olyan igét ad meg, amelyet a kiszolgáló nem ért meg, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.
Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address
Note
Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.
A következőre érvényes:
UploadValues(Uri, String, NameValueCollection)
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
- Forrás:
- WebClient.cs
Feltölti a megadott nevet/értékgyűjteményt a megadott URI által azonosított erőforrásba a megadott módszerrel.
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()Paraméterek
- address
- Uri
A gyűjtemény fogadásához tartozó erőforrás URI-ja.
- method
- String
A fájl erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.
- data
- NameValueCollection
Az NameValueCollection erőforrásnak küldendő.
Válaszok
Az Byte erőforrás válaszának törzsét tartalmazó tömb.
Kivételek
A address paraméter a következő null: .
-vagy-
A data paraméter a következő null: .
A kombinálással BaseAddressaddress létrehozott URI érvénytelen.
-vagy-
data az null.
-vagy-
Hiba történt a stream megnyitása közben.
-vagy-
Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.
-vagy-
A Content-type fejléc értéke nem, és nem nullapplication/x-www-form-urlencodedis.
Megjegyzések
Figyelmeztetés
WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.
A UploadValues metódus a paraméterben NameValueCollection megadott metódus használatával küld egy method erőforrást egy erőforrásnak, és visszaadja a kiszolgáló válaszait. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadValuesAsync .
Ha a Content-type fejléc az null, akkor a metódus a UploadValues következőre application/x-www-form-urlencodedállítja: .
Ha a method paraméter olyan igét ad meg, amelyet a kiszolgáló nem ért meg, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.
Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address
Note
Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.
