WebClient.UploadValuesTaskAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
UploadValuesTaskAsync(String, String, NameValueCollection)	Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.
UploadValuesTaskAsync(String, NameValueCollection)	Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.
UploadValuesTaskAsync(Uri, NameValueCollection)	Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.
UploadValuesTaskAsync(Uri, String, NameValueCollection)	Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.

UploadValuesTaskAsync(String, String, NameValueCollection)

Forrás:

WebClient.cs

Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())

Paraméterek

address

String

A gyűjtemény fogadásához tartozó erőforrás URI-ja.

method

String

A gyűjtemény erőforrásnak 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

NameValueCollection

Az NameValueCollection erőforrásnak küldendő.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága egy Byte tömböt ad vissza, amely a kiszolgáló által küldött választ tartalmazza.

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.

-vagy-

Hiba történt a stream megnyitása közben.

-vagy-

A Content-type fejléc nem null vagy "application/x-www-form-urlencoded".

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 név/érték gyűjtemény erőforrásba való feltöltése után fejeződik be. A név/érték gyűjtemény aszinkron módon lesz elküldve 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.

Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

Ha a Tartalom típusú fejléc az null, akkor ez a metódus az "application/x-www-form-urlencoded" értékre állítja.

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

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

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.

UploadValuesTaskAsync(String, NameValueCollection)

Forrás:

WebClient.cs

Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())

Paraméterek

address

String

A gyűjtemény fogadásához tartozó erőforrás URI-ja.

data

NameValueCollection

Az NameValueCollection erőforrásnak küldendő.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága egy Byte tömböt ad vissza, amely a kiszolgáló által küldött választ tartalmazza.

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.

-vagy-

Hiba történt a stream megnyitása közben.

-vagy-

A Content-type fejléc nem null vagy "application/x-www-form-urlencoded".

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 név/érték gyűjtemény erőforrásba való feltöltése után fejeződik be. A név/érték gyűjtemény aszinkron módon lesz elküldve 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.

Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

Ha a Tartalom típusú fejléc az null, akkor ez a metódus az "application/x-www-form-urlencoded" értékre állítja.

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

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

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.

UploadValuesTaskAsync(Uri, NameValueCollection)

Forrás:

WebClient.cs

Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

Paraméterek

address

Uri

A gyűjtemény fogadásához tartozó erőforrás URI-ja.

data

NameValueCollection

Az NameValueCollection erőforrásnak küldendő.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága egy Byte tömböt ad vissza, amely a kiszolgáló által küldött választ tartalmazza.

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-

Hiba történt a stream megnyitása közben.

-vagy-

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

-vagy-

A Content-type fejléc értéke nem, és nem nullapplication/x-www-form-urlencodedis.

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 név/érték gyűjtemény erőforrásba való feltöltése után fejeződik be. A név/érték gyűjtemény aszinkron módon lesz elküldve 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.

Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

Ha a Tartalom típusú fejléc az null, akkor ez a metódus az "application/x-www-form-urlencoded" értékre állítja.

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

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

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.

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Forrás:

WebClient.cs

Feltölti a megadott nevet/értékgyűjteményt a megadott URI által aszinkron műveletként azonosított erőforrásba egy tevékenységobjektum használatával.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())

Paraméterek

address

Uri

A gyűjtemény fogadásához tartozó erőforrás URI-ja.

method

String

A gyűjtemény erőforrásnak 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

NameValueCollection

Az NameValueCollection erőforrásnak küldendő.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result feladatobjektum tulajdonsága egy Byte tömböt ad vissza, amely a kiszolgáló által küldött választ tartalmazza.

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.

-vagy-

Hiba történt a stream megnyitása közben.

-vagy-

A Content-type fejléc nem null vagy "application/x-www-form-urlencoded".

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 név/érték gyűjtemény erőforrásba való feltöltése után fejeződik be. A név/érték gyűjtemény aszinkron módon lesz elküldve 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.

Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

Ha a Tartalom típusú fejléc az null, akkor ez a metódus az "application/x-www-form-urlencoded" értékre állítja.

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

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

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.