WebClient.UploadData Methode

Definition

Lädt einen Datenpuffer in eine Ressource mit dem angegebenen URI hoch.

Überlädt

UploadData(String, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.

UploadData(Uri, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.

UploadData(String, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.

UploadData(Uri, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.

UploadData(String, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.

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

Der URI der Ressource, die die Daten empfangen soll.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.

Ausnahmen

Der address-Parameter ist null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

data ist null.

- oder -

Fehler beim Senden der Daten.

- oder -

Der Server, der Host dieser Ressource ist, hat nicht geantwortet.

Beispiele

Im folgenden Codebeispiel wird eine aus der Konsole eingegebene Zeichenfolge in ein Byte Array konvertiert und das Array mithilfe UploadDatavon an den angegebenen Server übergeben. Jede Antwort vom Server wird 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;
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 an eine Ressource.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet. 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.

Die UploadData -Methode sendet den Inhalt von data ohne Codierung an den 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 UploadDataAsync-Methoden verwenden.

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:

UploadData(Uri, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.

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

Der URI der Ressource, die die Daten empfangen soll.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.

Ausnahmen

Der address-Parameter ist null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

data ist null.

- oder -

Fehler beim Senden der Daten.

- oder -

Der Server, der Host dieser Ressource ist, hat nicht geantwortet.

Hinweise

Die UploadData -Methode sendet einen Datenpuffer an eine Ressource.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet. 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.

Die UploadData -Methode sendet den Inhalt von data ohne Codierung an den 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 UploadDataAsync-Methoden verwenden.

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:

UploadData(String, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.

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

Der URI der Ressource, die die Daten empfangen soll.

method
String

Die HTTP-Methode zum Senden der Daten an die Ressource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.

Ausnahmen

Der address-Parameter ist null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

data ist null.

- oder -

Fehler beim Hochladen der Daten.

- oder -

Der Server, der Host dieser Ressource ist, hat nicht geantwortet.

Beispiele

Im folgenden Codebeispiel wird eine von der Konsole eingegebene Zeichenfolge in ein Bytearray konvertiert und das Array mithilfe UploadDatavon an den angegebenen Server übertragen. Jede Antwort vom Server wird der Konsole angezeigt.

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 mithilfe der im method Parameter angegebenen HTTP-Methode an 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 UploadDataAsync-Methoden verwenden.

Die UploadData -Methode sendet den Inhalt von data ohne Codierung an den Server.

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:

UploadData(Uri, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.

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

Der URI der Ressource, die die Daten empfangen soll.

method
String

Die HTTP-Methode zum Senden der Daten an die Ressource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.

data
Byte[]

Der an die Ressource zu sendende Datenpuffer.

Gibt zurück

Byte[]

Ein Byte-Array mit dem Textkörper der Ressourcenantwort.

Ausnahmen

Der address-Parameter ist null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

data ist null.

- oder -

Fehler beim Hochladen der Daten.

- oder -

Der Server, der Host dieser Ressource ist, hat nicht geantwortet.

Hinweise

Die UploadData -Methode sendet einen Datenpuffer mithilfe der im method Parameter angegebenen HTTP-Methode an 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 UploadDataAsync-Methoden verwenden.

Die UploadData -Methode sendet den Inhalt von data ohne Codierung an den Server.

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: