WebClient.UploadValues Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Lädt eine Name-Wert-Auflistung in eine Ressource mit dem angegebenen URI hoch.
Überlädt
| UploadValues(String, NameValueCollection) |
Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch. |
| UploadValues(Uri, NameValueCollection) |
Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch. |
| UploadValues(String, String, NameValueCollection) |
Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch. |
| UploadValues(Uri, String, NameValueCollection) |
Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch. |
UploadValues(String, NameValueCollection)
Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.
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()Parameter
- address
- String
Der URI der Ressource, die die Auflistung empfangen soll.
- data
- NameValueCollection
Die an die Ressource zu sendende NameValueCollection.
Gibt zurück
Ein Byte-Array mit dem Textkörper der Ressourcenantwort.
Ausnahmen
Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.
- oder -
data ist null.
- oder -
Der Server, der Host dieser Ressource ist, hat nicht geantwortet.
- oder -
Fehler beim Öffnen des Streams.
- oder -
Der Content-type-Header ist nicht null oder "application/x-www-form-urlencoded".
Beispiele
Im folgenden Codebeispiel werden Informationen vom Benutzer (Name, Alter und Adresse) gesammelt und die Werte mithilfe von an den Server bereitgestellt UploadValues. Jede Antwort vom Server wird in der Konsole angezeigt.
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))
Hinweise
Die UploadValues -Methode sendet einen NameValueCollection an einen Server. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadValuesAsync-Methoden verwenden.
Wenn die zugrunde liegende Anforderung vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was geschieht. In der Regel wird ein WebException ausgelöst, wobei die Status Eigenschaft festgelegt ist, um den Fehler anzugeben.
Wenn der Content-type-Header lautet null, legt die UploadValues Methode ihn auf "application/x-www-form-urlencoded" fest.
Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.
Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.
Hinweis
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.
Gilt für:
UploadValues(Uri, NameValueCollection)
Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.
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()Parameter
- address
- Uri
Der URI der Ressource, die die Auflistung empfangen soll.
- data
- NameValueCollection
Die an die Ressource zu sendende NameValueCollection.
Gibt zurück
Ein Byte-Array mit dem Textkörper der Ressourcenantwort.
Ausnahmen
Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.
- oder -
data ist null.
- oder -
Der Server, der Host dieser Ressource ist, hat nicht geantwortet.
- oder -
Fehler beim Öffnen des Streams.
- oder -
Der Content-type-Header ist nicht null oder "application/x-www-form-urlencoded".
Hinweise
Die UploadValues -Methode sendet einen NameValueCollection an einen Server. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadValuesAsync-Methoden verwenden.
Wenn die zugrunde liegende Anforderung vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was geschieht. In der Regel wird ein WebException ausgelöst, wobei die Status Eigenschaft festgelegt ist, um den Fehler anzugeben.
Wenn der Content-type-Header lautet null, legt die UploadValues Methode ihn auf "application/x-www-form-urlencoded" fest.
Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.
Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.
Hinweis
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.
Gilt für:
UploadValues(String, String, NameValueCollection)
Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch.
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()Parameter
- address
- String
Der URI der Ressource, die die Auflistung empfangen soll.
- method
- String
Die HTTP-Methode zum Senden der Datei an die Ressource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.
- data
- NameValueCollection
Die an die Ressource zu sendende NameValueCollection.
Gibt zurück
Ein Byte-Array mit dem Textkörper der Ressourcenantwort.
Ausnahmen
Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.
- oder -
data ist null.
- oder -
Fehler beim Öffnen des Streams.
- oder -
Der Server, der Host dieser Ressource ist, hat nicht geantwortet.
- oder -
Der Wert des Content-type-Headers ist weder null noch application/x-www-form-urlencoded.
Beispiele
Im folgenden Codebeispiel werden Informationen vom Benutzer (Name, Alter und Adresse) gesammelt und die Werte mithilfe von an den Server bereitgestellt UploadValues. Jede Antwort vom Server wird in der Konsole angezeigt.
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))
Hinweise
Die UploadValues -Methode sendet eine NameValueCollection an eine Ressource mit der im method -Parameter angegebenen Methode und gibt jede Antwort vom Server zurück. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadValuesAsync-Methoden verwenden.
Wenn der Content-type Header ist, legt nulldie UploadValues -Methode ihn auf fest application/x-www-form-urlencoded.
Wenn der method Parameter ein Verb angibt, das vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was geschieht. In der Regel wird ein WebException ausgelöst, wobei die Status Eigenschaft festgelegt ist, um den Fehler anzugeben.
Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.
Hinweis
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.
Gilt für:
UploadValues(Uri, String, NameValueCollection)
Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch.
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()Parameter
- address
- Uri
Der URI der Ressource, die die Auflistung empfangen soll.
- method
- String
Die HTTP-Methode zum Senden der Datei an die Ressource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.
- data
- NameValueCollection
Die an die Ressource zu sendende NameValueCollection.
Gibt zurück
Ein Byte-Array mit dem Textkörper der Ressourcenantwort.
Ausnahmen
Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.
- oder -
data ist null.
- oder -
Fehler beim Öffnen des Streams.
- oder -
Der Server, der Host dieser Ressource ist, hat nicht geantwortet.
- oder -
Der Wert des Content-type-Headers ist weder null noch application/x-www-form-urlencoded.
Hinweise
Die UploadValues -Methode sendet mithilfe der im method -Parameter angegebenen Methode an NameValueCollection eine Ressource und gibt jede Antwort vom Server zurück. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadValuesAsync-Methoden verwenden.
Wenn der Content-type Header ist null, legt die UploadValues -Methode ihn auf fest application/x-www-form-urlencoded.
Wenn der method Parameter ein Verb angibt, das vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was geschieht. In der Regel wird eine WebException ausgelöst, wobei die Status -Eigenschaft festgelegt ist, um den Fehler anzugeben.
Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss ein relativer URI sein, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.
Hinweis
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter: https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für