WebClient.UploadStringTaskAsync WebClient.UploadStringTaskAsync WebClient.UploadStringTaskAsync WebClient.UploadStringTaskAsync Method

Definition

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object. Durch diese Methoden wird der aufrufende Thread nicht blockiert.These methods do not block the calling thread.

Überlädt

UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::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>
Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of String)

Parameter

address
Uri Uri Uri Uri

Der URI der Ressource, die die Zeichenfolge empfangen soll.The URI of the resource to receive the string. 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.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String String String String

Die HTTP-Methode zum Senden der Datei an die Ressource.The HTTP method used to send the file to the resource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.If null, the default is POST for http and STOR for ftp.

data
String String String String

Die Uploadzeichenfolge.The string to be uploaded.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.The Result property on the task object returns a String containing the response sent by the server.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

- oder --or- Der data-Parameter ist null.The data parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- method kann nicht zum Senden von Inhalten verwendet werden.method cannot be used to send content.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem auf die Ressource die Zeichenfolge hochgeladen wurde.The returned Task<TResult> object will complete after the string has been uploaded to the resource. Die Zeichenfolge wird asynchron mit Thread-Ressourcen, die automatisch zugewiesen werden aus dem Threadpool gesendet.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Asynchrone Vorgänge, die nicht abgeschlossen wurden können abgebrochen werden, mithilfe der CancelAsync Methode.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Diese Methode vor dem Hochladen der Zeichenfolge, konvertiert sie in einer Byte array mit der Codierung angegeben werden, der Encoding Eigenschaft.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Diese Methode blockiert, während der Übertragung der Zeichenfolge.This method blocks while the string is transmitted.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::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>
Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of String)

Parameter

address
String String String String

Der URI der Ressource, die die Zeichenfolge empfangen soll.The URI of the resource to receive the string. 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.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String String String String

Die HTTP-Methode zum Senden der Datei an die Ressource.The HTTP method used to send the file to the resource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.If null, the default is POST for http and STOR for ftp.

data
String String String String

Die Uploadzeichenfolge.The string to be uploaded.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.The Result property on the task object returns a String containing the response sent by the server.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

- oder --or- Der data-Parameter ist null.The data parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- method kann nicht zum Senden von Inhalten verwendet werden.method cannot be used to send content.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem auf die Ressource die Zeichenfolge hochgeladen wurde.The returned Task<TResult> object will complete after the string has been uploaded to the resource. Die Zeichenfolge wird asynchron mit Thread-Ressourcen, die automatisch zugewiesen werden aus dem Threadpool gesendet.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Asynchrone Vorgänge, die nicht abgeschlossen wurden können abgebrochen werden, mithilfe der CancelAsync Methode.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Diese Methode vor dem Hochladen der Zeichenfolge, konvertiert sie in einer Byte array mit der Codierung angegeben werden, der Encoding Eigenschaft.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Diese Methode blockiert, während der Übertragung der Zeichenfolge.This method blocks while the string is transmitted.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::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>
Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

Parameter

address
String String String String

Der URI der Ressource, die die Zeichenfolge empfangen soll.The URI of the resource to receive the string. 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.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

data
String String String String

Die Uploadzeichenfolge.The string to be uploaded.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.The Result property on the task object returns a String containing the response sent by the server.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

- oder --or- Der data-Parameter ist null.The data parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem auf die Ressource die Zeichenfolge hochgeladen wurde.The returned Task<TResult> object will complete after the string has been uploaded to the resource. Die Zeichenfolge wird asynchron mit Thread-Ressourcen, die automatisch zugewiesen werden aus dem Threadpool gesendet.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Asynchrone Vorgänge, die nicht abgeschlossen wurden können abgebrochen werden, mithilfe der CancelAsync Methode.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Diese Methode vor dem Hochladen der Zeichenfolge, konvertiert sie in einer Byte array mit der Codierung angegeben werden, der Encoding Eigenschaft.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Diese Methode blockiert, während der Übertragung der Zeichenfolge.This method blocks while the string is transmitted.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String)

Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::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>
Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of String)

Parameter

address
Uri Uri Uri Uri

Der URI der Ressource, die die Zeichenfolge empfangen soll.The URI of the resource to receive the string. 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.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

data
String String String String

Die Uploadzeichenfolge.The string to be uploaded.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation. Die Result-Eigenschaft im Task-Objekt gibt ein String zurück, das die Antwort enthält, die vom Server gesendet wird.The Result property on the task object returns a String containing the response sent by the server.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

- oder --or- Der data-Parameter ist null.The data parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- Der Server, der Host dieser Ressource ist, hat nicht geantwortet.There was no response from the server hosting the resource.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem auf die Ressource die Zeichenfolge hochgeladen wurde.The returned Task<TResult> object will complete after the string has been uploaded to the resource. Die Zeichenfolge wird asynchron mit Thread-Ressourcen, die automatisch zugewiesen werden aus dem Threadpool gesendet.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Asynchrone Vorgänge, die nicht abgeschlossen wurden können abgebrochen werden, mithilfe der CancelAsync Methode.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Diese Methode vor dem Hochladen der Zeichenfolge, konvertiert sie in einer Byte array mit der Codierung angegeben werden, der Encoding Eigenschaft.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Diese Methode blockiert, während der Übertragung der Zeichenfolge.This method blocks while the string is transmitted.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString -Eigenschaft keine leere Zeichenfolge ist, wird dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: