WebClient.UploadStringTaskAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
UploadStringTaskAsync(Uri, String, String)	A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.
UploadStringTaskAsync(String, String, String)	A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.
UploadStringTaskAsync(String, String)	A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.
UploadStringTaskAsync(Uri, String)	A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.

UploadStringTaskAsync(Uri, String, String)

Forrás:

WebClient.cs

A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.

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);

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)

Paraméterek

address

Uri

A sztring fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

method

String

A fájl erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

data

String

A feltöltendő sztring.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága a String kiszolgáló által küldött választ tartalmazó értéket adja vissza.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

method nem használható tartalom küldésére.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a sztring erőforrásba való feltöltése után fejeződik be. A sztringet aszinkron módon küldi el a rendszer a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadStringTaskAsync(String, String, String)

Forrás:

WebClient.cs

A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.

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);

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)

Paraméterek

address

String

A sztring fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

method

String

A fájl erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

data

String

A feltöltendő sztring.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága a String kiszolgáló által küldött választ tartalmazó értéket adja vissza.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

method nem használható tartalom küldésére.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a sztring erőforrásba való feltöltése után fejeződik be. A sztringet aszinkron módon küldi el a rendszer a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadStringTaskAsync(String, String)

Forrás:

WebClient.cs

A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.

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);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

Paraméterek

address

String

A sztring fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

data

String

A feltöltendő sztring.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága a String kiszolgáló által küldött választ tartalmazó értéket adja vissza.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a sztring erőforrásba való feltöltése után fejeződik be. A sztringet aszinkron módon küldi el a rendszer a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadStringTaskAsync(Uri, String)

Forrás:

WebClient.cs

A megadott sztringet egy tevékenységobjektum használatával aszinkron műveletként tölti fel a megadott erőforrásba.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

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)

Paraméterek

address

Uri

A sztring fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

data

String

A feltöltendő sztring.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága a String kiszolgáló által küldött választ tartalmazó értéket adja vissza.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a sztring erőforrásba való feltöltése után fejeződik be. A sztringet aszinkron módon küldi el a rendszer a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.