Teilen über

WebClient.UploadData Methode

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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 durch einen URI identifiziert wird.
UploadData(Uri, Byte[])

Lädt einen Datenpuffer in eine Ressource hoch, die durch einen URI identifiziert wird.
UploadData(String, String, Byte[])

Lädt einen Datenpuffer mithilfe der angegebenen Methode in die angegebene Ressource hoch.
UploadData(Uri, String, Byte[])

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

UploadData(String, Byte[])

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Lädt einen Datenpuffer in eine Ressource hoch, die durch einen 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 empfängt.

data
Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

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.

WebException

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

-oder-

data ist null.

-oder-

Fehler beim Senden der Daten.

-oder-

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

Beispiele

Im folgenden Codebeispiel wird eine aus der Konsole eingegebene Zeichenfolge in ein Byte Array konvertiert und das Array mithilfe von UploadDataauf dem angegebenen 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;
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

Vorsicht

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

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 auftritt. In der Regel wird ein WebException ausgelöst, wobei die Status-Eigenschaft festgelegt ist, um den Fehler anzugeben.

Die UploadData-Methode sendet den Inhalt data ohne Codierung an den Server. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie weiterhin auf die Antwort des Servers warten möchten, verwenden Sie eine der UploadDataAsync Methoden.

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.

Gilt für:

UploadData(Uri, Byte[])

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Lädt einen Datenpuffer in eine Ressource hoch, die durch einen 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 empfängt.

data
Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

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.

WebException

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

-oder-

data ist null.

-oder-

Fehler beim Senden der Daten.

-oder-

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

Hinweise

Vorsicht

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

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 auftritt. In der Regel wird ein WebException ausgelöst, wobei die Status-Eigenschaft festgelegt ist, um den Fehler anzugeben.

Die UploadData-Methode sendet den Inhalt data ohne Codierung an den Server. Diese Methode blockiert beim Hochladen der Daten. Wenn Sie weiterhin auf die Antwort des Servers warten möchten, verwenden Sie eine der UploadDataAsync Methoden.

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.

Gilt für:

UploadData(String, String, Byte[])

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Lädt einen Datenpuffer mithilfe der angegebenen Methode in die angegebene Ressource 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 empfängt.

method
String

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

data
Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

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.

WebException

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

-oder-

data ist null.

-oder-

Fehler beim Hochladen der Daten.

-oder-

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

Beispiele

Im folgenden Codebeispiel wird eine aus der Konsole eingegebene Zeichenfolge in ein Bytearray konvertiert und das Array mithilfe von UploadDataauf dem angegebenen Server bereitgestellt. Jede Antwort vom Server wird auf 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

Vorsicht

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

Die UploadData-Methode sendet einen Datenpuffer mithilfe der im method Parameter angegebenen HTTP-Methode an eine Ressource und gibt alle Antworten 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 UploadDataAsync Methoden.

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

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.

Gilt für:

UploadData(Uri, String, Byte[])

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Lädt einen Datenpuffer mithilfe der angegebenen Methode in die angegebene Ressource 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 empfängt.

method
String

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

data
Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

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.

WebException

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

-oder-

data ist null.

-oder-

Fehler beim Hochladen der Daten.

-oder-

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

Hinweise

Vorsicht

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

Die UploadData-Methode sendet einen Datenpuffer mithilfe der im method Parameter angegebenen HTTP-Methode an eine Ressource und gibt alle Antworten 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 UploadDataAsync Methoden.

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

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.

Gilt für: