WebClient.UploadValues Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Lädt eine Namens-/Wertauflistung in eine Ressource mit dem angegebenen URI hoch.

Überlädt

UploadValues(String, NameValueCollection)	Lädt die angegebene Namens-/Wertauflistung in die ressource hoch, die durch den angegebenen URI identifiziert wird.
UploadValues(Uri, NameValueCollection)	Lädt die angegebene Namens-/Wertauflistung in die ressource hoch, die durch den angegebenen URI identifiziert wird.
UploadValues(String, String, NameValueCollection)	Lädt die angegebene Namens-/Wertauflistung mithilfe der angegebenen Methode in die ressource hoch, die durch den angegebenen URI identifiziert wird.
UploadValues(Uri, String, NameValueCollection)	Lädt die angegebene Namens-/Wertauflistung mithilfe der angegebenen Methode in die ressource hoch, die durch den angegebenen URI identifiziert wird.

UploadValues(String, NameValueCollection)

Quelle:

WebClient.cs

Lädt die angegebene Namens-/Wertauflistung in die ressource hoch, die durch den angegebenen URI identifiziert wird.

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 Sammlung empfangen soll.

data

NameValueCollection

Die NameValueCollection, die an die Ressource gesendet werden sollen.

Gibt zurück

Byte[]

Ein Byte Array, das den Textkörper der Antwort aus der Ressource enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

data ist null.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Der Content-type Header ist nicht null oder "application/x-www-form-urlencoded".

Beispiele

Im folgenden Codebeispiel werden Informationen aus dem Benutzer (Name, Alter und Adresse) gesammelt und die Werte mithilfe von UploadValuesauf dem Server bereitgestellt. Jede Antwort vom Server wird auf 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

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die UploadValues-Methode sendet eine NameValueCollection an einen Server. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie weiterhin auf die Antwort des Servers warten möchten, verwenden Sie eine der UploadValuesAsync Methoden.

Wenn die zugrunde liegende Anforderung vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. In der Regel wird ein WebException ausgelöst, wobei die Status-Eigenschaft festgelegt ist, um den Fehler anzugeben.

Wenn der Inhaltstypheader nullist, legt die UploadValues-Methode sie auf "application/x-www-form-urlencoded" fest.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString 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.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

UploadValues(Uri, NameValueCollection)

Quelle:

WebClient.cs

Lädt die angegebene Namens-/Wertauflistung in die ressource hoch, die durch den angegebenen URI identifiziert wird.

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 Sammlung empfangen soll.

data

NameValueCollection

Die NameValueCollection, die an die Ressource gesendet werden sollen.

Gibt zurück

Byte[]

Ein Byte Array, das den Textkörper der Antwort aus der Ressource enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

data ist null.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Der Content-type Header ist nicht null oder "application/x-www-form-urlencoded".

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die UploadValues-Methode sendet eine NameValueCollection an einen Server. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie weiterhin auf die Antwort des Servers warten möchten, verwenden Sie eine der UploadValuesAsync Methoden.

Wenn die zugrunde liegende Anforderung vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. In der Regel wird ein WebException ausgelöst, wobei die Status-Eigenschaft festgelegt ist, um den Fehler anzugeben.

Wenn der Inhaltstypheader nullist, legt die UploadValues-Methode sie auf "application/x-www-form-urlencoded" fest.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString 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.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

UploadValues(String, String, NameValueCollection)

Quelle:

WebClient.cs

Lädt die angegebene Namens-/Wertauflistung mithilfe der angegebenen Methode in die ressource hoch, die durch den angegebenen URI identifiziert wird.

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

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 Sammlung empfangen soll.

method

String

Die HTTP-Methode, die zum Senden der Datei an die Ressource verwendet wird. Wenn NULL, ist der Standardwert POST für HTTP und STOR für ftp.

data

NameValueCollection

Die NameValueCollection, die an die Ressource gesendet werden sollen.

Gibt zurück

Byte[]

Ein Byte Array, das den Textkörper der Antwort aus der Ressource enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

data ist null.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

-oder-

Der Content-type Kopfzeilenwert ist nicht null und nicht application/x-www-form-urlencoded.

Beispiele

Im folgenden Codebeispiel werden Informationen aus dem Benutzer (Name, Alter und Adresse) gesammelt und die Werte mithilfe von UploadValuesauf dem Server bereitgestellt. Jede Antwort vom Server wird auf 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

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die UploadValues-Methode sendet eine NameValueCollection mithilfe der im parameter method angegebenen Methode an eine Ressource und gibt eine Antwort vom Server zurück. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie weiterhin auf die Antwort des Servers warten möchten, verwenden Sie eine der UploadValuesAsync Methoden.

Wenn die Content-type Kopfzeile nullist, legt die UploadValues-Methode sie auf application/x-www-form-urlencodedfest.

Wenn der parameter method ein Verb angibt, das vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. 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 address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

UploadValues(Uri, String, NameValueCollection)

Quelle:

WebClient.cs

Lädt die angegebene Namens-/Wertauflistung mithilfe der angegebenen Methode in die ressource hoch, die durch den angegebenen URI identifiziert wird.

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

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 Sammlung empfangen soll.

method

String

Die HTTP-Methode, die zum Senden der Datei an die Ressource verwendet wird. Wenn NULL, ist der Standardwert POST für HTTP und STOR für ftp.

data

NameValueCollection

Die NameValueCollection, die an die Ressource gesendet werden sollen.

Gibt zurück

Byte[]

Ein Byte Array, das den Textkörper der Antwort aus der Ressource enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

data ist null.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

-oder-

Der Content-type Kopfzeilenwert ist nicht null und nicht application/x-www-form-urlencoded.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die UploadValues-Methode sendet eine NameValueCollection mithilfe der im parameter method angegebenen Methode an eine Ressource und gibt eine Antwort vom Server zurück. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie weiterhin auf die Antwort des Servers warten möchten, verwenden Sie eine der UploadValuesAsync Methoden.

Wenn die Content-type Kopfzeile nullist, legt die UploadValues-Methode sie auf application/x-www-form-urlencodedfest.

Wenn der parameter method ein Verb angibt, das vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. 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 address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.