WebClient.UploadStringTaskAsync Methode

Definition

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch. Durch diese Methoden wird der aufrufende Thread nicht blockiert.

Überlädt

UploadStringTaskAsync(Uri, String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

UploadStringTaskAsync(String, String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

UploadStringTaskAsync(String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

UploadStringTaskAsync(Uri, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

UploadStringTaskAsync(Uri, String, String)

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

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string? method, string data);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);
member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>
Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of 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.

method
String

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

data
String

Die Uploadzeichenfolge.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.

Attribute

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 -

method kann nicht zum Senden von Inhalten verwendet werden.

- oder -

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

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die Zeichenfolge in die Ressource hochgeladen wurde. Die Zeichenfolge wird asynchron mit Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

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.

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:

UploadStringTaskAsync(String, String, String)

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

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string? method, string data);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);
member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>
Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of 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.

method
String

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

data
String

Die Uploadzeichenfolge.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.

Attribute

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 -

method kann nicht zum Senden von Inhalten verwendet werden.

- oder -

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

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die Zeichenfolge in die Ressource hochgeladen wurde. Die Zeichenfolge wird asynchron mit Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

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.

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:

UploadStringTaskAsync(String, String)

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

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);
member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>
Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of 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

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.

Attribute

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

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die Zeichenfolge in die Ressource hochgeladen wurde. Die Zeichenfolge wird asynchron mit Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

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.

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:

UploadStringTaskAsync(Uri, String)

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

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);
member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>
Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of 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

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.

Attribute

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

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die Zeichenfolge in die Ressource hochgeladen wurde. Die Zeichenfolge wird asynchron mit Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

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.

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: