WebClient.UploadData WebClient.UploadData WebClient.UploadData WebClient.UploadData Method

Definition

Lädt einen Datenpuffer in eine Ressource mit dem angegebenen URI hoch.Uploads a data buffer to a resource with the specified URI.

Überlädt

UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.Uploads a data buffer to a resource identified by a URI.

UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.Uploads a data buffer to a resource identified by a URI.

UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.Uploads a data buffer to the specified resource, using the specified method.

UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.Uploads a data buffer to the specified resource, using the specified method.

UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.Uploads a data buffer to a resource identified by a 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()

Parameter

address
String String String String

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.The data buffer to send to the resource.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.A Byte array containing the body of the response from the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- data ist null.data is null.

- oder --or- Fehler beim Senden der Daten.An error occurred while sending the data.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Beispiele

Im folgenden Codebeispiel wird konvertiert eine Zeichenfolge, die aus der Konsole eine Byte array und das Array mit dem angegebenen Server UploadData.The following code example converts a string entered from the console to a Byte array and posts the array to the specified server using UploadData. Antwort vom Server wird in der Konsole angezeigt.Any response from the server is displayed to the console.

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

Hinweise

Die UploadData Methode sendet einen Datenpuffer in eine Ressource.The UploadData method sends a data buffer to a resource.

Diese Methode verwendet den STOR-Befehl zum Hochladen von einer FTP-Ressource.This method uses the STOR command to upload an FTP resource. Für eine HTTP-Ressource wird die POST-Methode verwendet.For an HTTP resource, the POST method is used. Wenn die zugrunde liegende Anforderung vom Server nicht verstanden wird, bestimmen die zugrunde liegende Protokoll Abläufe.If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. In der Regel eine WebException ausgelöst und die Status Eigenschaft festgelegt wird, um den Fehler anzugeben.Typically, a WebException is thrown with the Status property set to indicate the error.

Die UploadData Methode sendet den Inhalt des data an den Server, ohne ihn zu codieren.The UploadData method sends the content of data to the server without encoding it. Diese Methode blockiert, während des Hochladens der das.This method blocks while uploading the data. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadDataAsync-Methoden verwenden.To continue executing while waiting for the server's response, use one of the UploadDataAsync methods.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.Uploads a data buffer to a resource identified by a 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()

Parameter

address
Uri Uri Uri Uri

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.The data buffer to send to the resource.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.A Byte array containing the body of the response from the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- data ist null.data is null.

- oder --or- Fehler beim Senden der Daten.An error occurred while sending the data.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Hinweise

Die UploadData Methode sendet einen Datenpuffer in eine Ressource.The UploadData method sends a data buffer to a resource.

Diese Methode verwendet den STOR-Befehl zum Hochladen von einer FTP-Ressource.This method uses the STOR command to upload an FTP resource. Für eine HTTP-Ressource wird die POST-Methode verwendet.For an HTTP resource, the POST method is used. Wenn die zugrunde liegende Anforderung vom Server nicht verstanden wird, bestimmen die zugrunde liegende Protokoll Abläufe.If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. In der Regel eine WebException ausgelöst und die Status Eigenschaft festgelegt wird, um den Fehler anzugeben.Typically, a WebException is thrown with the Status property set to indicate the error.

Die UploadData Methode sendet den Inhalt des data an den Server, ohne ihn zu codieren.The UploadData method sends the content of data to the server without encoding it. Diese Methode blockiert, während des Hochladens der das.This method blocks while uploading the data. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadDataAsync-Methoden verwenden.To continue executing while waiting for the server's response, use one of the UploadDataAsync methods.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.Uploads a data buffer to the specified resource, using the specified method.

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);
member this.UploadData : string * string * byte[] -> byte[]
Public Function UploadData (address As String, method As String, data As Byte()) As Byte()

Parameter

address
String String String String

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

method
String String String String

Die HTTP-Methode zum Senden der Daten an die Ressource.The HTTP method used to send the data to the resource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.If null, the default is POST for http and STOR for ftp.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.The data buffer to send to the resource.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.A Byte array containing the body of the response from the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- data ist null.data is null.

- oder --or- Fehler beim Hochladen der Daten.An error occurred while uploading the data.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Beispiele

Im folgenden Codebeispiel wird eine Zeichenfolge, die in der Konsole eingegeben haben, in ein Bytearray konvertiert und das Array mit dem angegebenen Server UploadData.The following code example converts a string entered from the console into a byte array and posts the array to the specified server using UploadData. Antwort vom Server wird in der Konsole angezeigt.Any response from the server is displayed to the console.

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

Hinweise

Die UploadData Methode sendet einen Datenpuffer auf eine Ressource mit der im angegebenen HTTP-Methode der method -Parameter und Antwort vom Server zurückgegeben.The UploadData method sends a data buffer to a resource using the HTTP method specified in the method parameter, and returns any response from the server. Diese Methode blockiert, während des Hochladens der das.This method blocks while uploading the data. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadDataAsync-Methoden verwenden.To continue executing while waiting for the server's response, use one of the UploadDataAsync methods.

Die UploadData Methode sendet den Inhalt des data an den Server, ohne ihn zu codieren.The UploadData method sends the content of data to the server without encoding it.

Wenn die method Parameter gibt an, ein Verb an, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Abläufe.If the method parameter specifies a verb that is not understood by the server, the underlying protocol classes determine what occurs. In der Regel eine WebException ausgelöst und die Status Eigenschaft festgelegt wird, um den Fehler anzugeben.Typically, a WebException is thrown with the Status property set to indicate the error.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.Uploads a data buffer to the specified resource, using the specified method.

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);
member this.UploadData : Uri * string * byte[] -> byte[]
Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()

Parameter

address
Uri Uri Uri Uri

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

method
String String String String

Die HTTP-Methode zum Senden der Daten an die Ressource.The HTTP method used to send the data to the resource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.If null, the default is POST for http and STOR for ftp.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.The data buffer to send to the resource.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.A Byte array containing the body of the response from the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- data ist null.data is null.

- oder --or- Fehler beim Hochladen der Daten.An error occurred while uploading the data.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Hinweise

Die UploadData Methode sendet einen Datenpuffer auf eine Ressource mit der im angegebenen HTTP-Methode der method -Parameter und Antwort vom Server zurückgegeben.The UploadData method sends a data buffer to a resource using the HTTP method specified in the method parameter, and returns any response from the server. Diese Methode blockiert, während des Hochladens der das.This method blocks while uploading the data. Wenn Sie eine Ressource herunterladen und beim Warten auf die Serverantwort die Ausführung fortsetzen möchten, können Sie eine der UploadDataAsync-Methoden verwenden.To continue executing while waiting for the server's response, use one of the UploadDataAsync methods.

Die UploadData Methode sendet den Inhalt des data an den Server, ohne ihn zu codieren.The UploadData method sends the content of data to the server without encoding it.

Wenn die method Parameter gibt an, ein Verb an, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Abläufe.If the method parameter specifies a verb that is not understood by the server, the underlying protocol classes determine what occurs. In der Regel eine WebException ausgelöst und die Status Eigenschaft festgelegt wird, um den Fehler anzugeben.Typically, a WebException is thrown with the Status property set to indicate the error.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: