WebClient.UploadString Methode

  • Referenz

Definition

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

Lädt die angegebene Zeichenfolge in die angegebene Ressource hoch.

Überlädt

UploadString(String, String)

Lädt die angegebene Zeichenfolge mithilfe der POST-Methode in die angegebene Ressource hoch.
UploadString(Uri, String)

Lädt die angegebene Zeichenfolge mithilfe der POST-Methode in die angegebene Ressource hoch.
UploadString(String, String, String)

Lädt die angegebene Zeichenfolge mithilfe der angegebenen Methode in die angegebene Ressource hoch.
UploadString(Uri, String, String)

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

UploadString(String, String)

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

Lädt die angegebene Zeichenfolge mithilfe der POST-Methode in die angegebene Ressource hoch.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ data);
public string UploadString (string address, string data);
member this.UploadString : string * string -> string
Public Function UploadString (address As String, data As String) As String

Parameter

address
String

Der URI der Ressource, die die Zeichenfolge empfängt. Für HTTP-Ressourcen muss dieser URI eine Ressource identifizieren, die eine mit der POST-Methode gesendete Anforderung akzeptieren kann, z. B. ein Skript oder eine ASP-Seite.

data
String

Die hochzuladende Zeichenfolge.

Gibt zurück

String

Eine String, die die vom Server gesendete Antwort enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

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

-oder-

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

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.

void UploadString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   WebClient^ client = gcnew WebClient;

   // Optionally specify an encoding for uploading and downloading strings.
   client->Encoding = System::Text::Encoding::UTF8;

   // Upload the data.
   String^ reply = client->UploadString( address, data );

   // Disply the server's response.
   Console::WriteLine( reply );
}

public static void UploadString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    WebClient client = new WebClient();
    // Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8;
    // Upload the data.
    string reply = client.UploadString(address, data);
    // Display the server's response.
    Console.WriteLine(reply);
}

Public Shared Sub UploadString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim client As WebClient = New WebClient()
    '  Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8
    '  Upload the data.
    Dim reply As String = client.UploadString(address, data)
    '  Disply the server's response.
    Console.WriteLine(reply)
End Sub

Hinweise

Vorsicht

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

Vor dem Hochladen der Zeichenfolge konvertiert diese Methode sie mithilfe der in der Encoding-Eigenschaft angegebenen Codierung in ein Byte Array. Diese Methode blockiert, während die Zeichenfolge übertragen wird. Um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers wartet, verwenden Sie eine der UploadStringAsync 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.

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.

Gilt für:

UploadString(Uri, String)

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

Lädt die angegebene Zeichenfolge mithilfe der POST-Methode in die angegebene Ressource hoch.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ data);
public string UploadString (Uri address, string data);
member this.UploadString : Uri * string -> string
Public Function UploadString (address As Uri, data As String) As String

Parameter

address
Uri

Der URI der Ressource, die die Zeichenfolge empfängt. Für HTTP-Ressourcen muss dieser URI eine Ressource identifizieren, die eine mit der POST-Methode gesendete Anforderung akzeptieren kann, z. B. ein Skript oder eine ASP-Seite.

data
String

Die hochzuladende Zeichenfolge.

Gibt zurück

String

Eine String, die die vom Server gesendete Antwort enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

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

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

Vor dem Hochladen der Zeichenfolge konvertiert diese Methode sie mithilfe der in der Encoding-Eigenschaft angegebenen Codierung in ein Byte Array. Diese Methode blockiert, während die Zeichenfolge übertragen wird. Um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers wartet, verwenden Sie eine der UploadStringAsync 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.

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.

Gilt für:

UploadString(String, String, String)

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

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

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);
public string UploadString (string address, string? method, string data);
public string UploadString (string address, string method, string data);
member this.UploadString : string * string * string -> string
Public Function UploadString (address As String, method As String, data As String) As String

Parameter

address
String

Der URI der Ressource, die die Zeichenfolge empfängt. Dieser URI muss eine Ressource identifizieren, die eine mit der method Methode gesendete Anforderung akzeptieren kann.

method
String

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

data
String

Die hochzuladende Zeichenfolge.

Gibt zurück

String

Eine String, die die vom Server gesendete Antwort enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

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

-oder-

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

-oder-

method können nicht zum Senden von Inhalten verwendet werden.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.

void PostString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   String^ method = "POST";
   WebClient^ client = gcnew WebClient;
   String^ reply = client->UploadString( address, method, data );
   Console::WriteLine( reply );
}

public static void PostString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    string method = "POST";
    WebClient client = new WebClient();
    string reply = client.UploadString(address, method, data);

    Console.WriteLine(reply);
}

Public Shared Sub PostString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim method As String = "POST"
    Dim client As WebClient = New WebClient()
    Dim reply As String = client.UploadString(address, method, data)

    Console.WriteLine(reply)
End Sub

Hinweise

Vorsicht

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

Vor dem Hochladen der Zeichenfolge konvertiert diese Methode sie mithilfe der in der Encoding-Eigenschaft angegebenen Codierung in ein Byte Array. Diese Methode blockiert, während die Zeichenfolge übertragen wird. Um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers wartet, verwenden Sie eine der UploadStringAsync 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:

UploadString(Uri, String, String)

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

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

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);
public string UploadString (Uri address, string? method, string data);
public string UploadString (Uri address, string method, string data);
member this.UploadString : Uri * string * string -> string
Public Function UploadString (address As Uri, method As String, data As String) As String

Parameter

address
Uri

Der URI der Ressource, die die Zeichenfolge empfängt. Dieser URI muss eine Ressource identifizieren, die eine mit der method Methode gesendete Anforderung akzeptieren kann.

method
String

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

data
String

Die hochzuladende Zeichenfolge.

Gibt zurück

String

Eine String, die die vom Server gesendete Antwort enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter data ist null.

WebException

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

-oder-

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

-oder-

method können nicht zum Senden von Inhalten verwendet werden.

Hinweise

Vorsicht

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

Vor dem Hochladen der Zeichenfolge konvertiert diese Methode sie mithilfe der in der Encoding-Eigenschaft angegebenen Codierung in ein Byte Array. Diese Methode blockiert, während die Zeichenfolge übertragen wird. Um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers wartet, verwenden Sie eine der UploadStringAsync 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: