WebClient.UploadString Methode

Definition

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

Überlädt

UploadString(String, String)

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

UploadString(Uri, String)

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

UploadString(String, String, String)

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

UploadString(Uri, String, String)

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

UploadString(String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der POST-Methode 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 empfangen soll. Für HTTP-Ressourcen muss dieser URI eine Ressource identifizieren, die eine mit der POST-Methode gesendete Anforderung annehmen kann, z. B. ein Skript oder eine ASP-Seite.

data
String

Die Uploadzeichenfolge.

Gibt zurück

Ein String, der die vom Server gesendete Antwort enthält.

Ausnahmen

Der address-Parameter ist null.

- oder -

Der data-Parameter ist null.

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

- oder -

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

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

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. Verwenden Sie eine der UploadStringAsync Methoden, um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers warten.

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.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.

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:

UploadString(Uri, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der POST-Methode 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 empfangen soll. Für HTTP-Ressourcen muss dieser URI eine Ressource identifizieren, die eine mit der POST-Methode gesendete Anforderung annehmen kann, z. B. ein Skript oder eine ASP-Seite.

data
String

Die Uploadzeichenfolge.

Gibt zurück

Ein String, der die vom Server gesendete Antwort enthält.

Ausnahmen

Der address-Parameter ist null.

- oder -

Der data-Parameter ist null.

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

- oder -

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

Hinweise

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. Verwenden Sie eine der UploadStringAsync Methoden, um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers warten.

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.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.

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:

UploadString(String, String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der angegebenen Methode 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 empfangen soll. Dieser URI muss eine Ressource identifizieren, die eine mit der method-Methode gesendete Anforderung annehmen kann.

method
String

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

data
String

Die Uploadzeichenfolge.

Gibt zurück

Ein String, der die vom Server gesendete Antwort enthält.

Ausnahmen

Der address-Parameter ist null.

- oder -

Der data-Parameter ist null.

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

- oder -

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

- oder -

method kann 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

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. Verwenden Sie eine der UploadStringAsync Methoden, um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers warten.

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:

UploadString(Uri, String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der angegebenen Methode 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 empfangen soll. Dieser URI muss eine Ressource identifizieren, die eine mit der method-Methode gesendete Anforderung annehmen kann.

method
String

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

data
String

Die Uploadzeichenfolge.

Gibt zurück

Ein String, der die vom Server gesendete Antwort enthält.

Ausnahmen

Der address-Parameter ist null.

- oder -

Der data-Parameter ist null.

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

- oder -

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

- oder -

method kann nicht zum Senden von Inhalten verwendet werden.

Hinweise

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. Verwenden Sie eine der UploadStringAsync Methoden, um eine Zeichenfolge zu senden und die Ausführung fortzusetzen, während sie auf die Antwort des Servers warten.

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: