WebClient.UploadDataAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Feltölt egy adatpuffert egy URI által azonosított erőforrásba. Ez a metódus nem blokkolja a hívó szálat.

Túlterhelések

Name	Description
UploadDataAsync(Uri, String, Byte[])	Feltölt egy adatpuffert egy URI által azonosított erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat.
UploadDataAsync(Uri, String, Byte[], Object)	Feltölt egy adatpuffert egy URI által azonosított erőforrásba a megadott módszerrel és a token azonosításával.
UploadDataAsync(Uri, Byte[])	Feltölt egy adatpuffert egy URI által azonosított erőforrásba a POST metódus használatával. Ez a metódus nem blokkolja a hívó szálat.

UploadDataAsync(Uri, String, Byte[])

Forrás:

WebClient.cs

Feltölt egy adatpuffert egy URI által azonosított erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public void UploadDataAsync(Uri address, string? method, byte[] data);

member this.UploadDataAsync : Uri * string * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte())

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Ha nullaz alapértelmezett érték a POST http és az ftp-hez tartozó STOR.

data

Byte[]

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

Kivételek

ArgumentNullException

A address 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.

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 metódus adatpuffert küld egy erőforrásnak. A rendszer aszinkron módon küldi el az adatpuffert a szálkészletből automatikusan lefoglalt szálerőforrások használatával. Az adatok nincsenek kódolva. Ha értesítést szeretne kapni az adatfeltöltés befejezéséről, adjon hozzá egy eseménykezelőt az UploadDataCompleted eseményhez.

Ez a metódus nem blokkolja a hívó szálat az adatok elküldése közben. Ha adatokat szeretne küldeni és letiltani a kiszolgáló válaszára való várakozás közben, használja az egyik metódust UploadData .

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

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.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által UploadData(Uri, String, Byte[])kiadott kivételeket: .

UploadDataAsync(Uri, String, Byte[], Object)

Forrás:

WebClient.cs

Feltölt egy adatpuffert egy URI által azonosított erőforrásba a megadott módszerrel és a token azonosításával.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);

public void UploadDataAsync(Uri address, string? method, byte[] data, object? userToken);

member this.UploadDataAsync : Uri * string * byte[] * obj -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Ha nullaz alapértelmezett érték a POST http és az ftp-hez tartozó STOR.

data

Byte[]

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

userToken

Object

Egy felhasználó által definiált objektum, amelyet a rendszer az aszinkron művelet befejezésekor meghívt metódusnak ad át.

Kivételek

ArgumentNullException

A address 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.

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 metódus adatpuffert küld egy erőforrásnak. A rendszer aszinkron módon küldi el az adatpuffert a szálkészletből automatikusan lefoglalt szálerőforrások használatával. Az adatok nincsenek kódolva. Ha értesítést szeretne kapni az adatfeltöltés befejezéséről, adjon hozzá egy eseménykezelőt az UploadDataCompleted eseményhez.

Ez a metódus nem blokkolja a hívó szálat az adatok elküldése közben. Ha adatokat szeretne küldeni és letiltani a kiszolgáló válaszára való várakozás közben, használja az egyik metódust UploadData .

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

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.

UploadDataAsync(Uri, Byte[])

Forrás:

WebClient.cs

Feltölt egy adatpuffert egy URI által azonosított erőforrásba a POST metódus használatával. Ez a metódus nem blokkolja a hívó szálat.

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public void UploadDataAsync(Uri address, byte[] data);

member this.UploadDataAsync : Uri * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, data As Byte())

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

data

Byte[]

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

Kivételek

ArgumentNullException

A address 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.

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 metódus adatpuffert küld egy erőforrásnak. A rendszer aszinkron módon küldi el az adatpuffert a szálkészletből automatikusan lefoglalt szálerőforrások használatával. Az adatok nincsenek kódolva. Ha értesítést szeretne kapni az adatfeltöltés befejezéséről, adjon hozzá egy eseménykezelőt az UploadDataCompleted eseményhez.

Ez a metódus nem blokkolja a hívó szálat az adatok elküldése közben. Ha adatokat szeretne küldeni és letiltani a kiszolgáló válaszára való várakozás közben, használja az egyik metódust UploadData .

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

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.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által UploadData(Uri, Byte[])kiadott kivételeket: .