WebClient.UploadValuesAsync 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 azonosított erőforrásba. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
UploadValuesAsync(Uri, NameValueCollection)	Feltölti a megadott név/érték gyűjtemény adatait a megadott URI által azonosított erőforrásba. Ez a metódus nem blokkolja a hívó szálat.
UploadValuesAsync(Uri, String, NameValueCollection)	Feltölti a megadott név/érték gyűjtemény adatait a megadott URI által azonosított erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat.
UploadValuesAsync(Uri, String, NameValueCollection, Object)	Feltölti a megadott név/érték gyűjtemény adatait a megadott URI által azonosított erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat, és lehetővé teszi, hogy a hívó átadjon egy objektumot a művelet befejezésekor meghívott metódusnak.

UploadValuesAsync(Uri, NameValueCollection)

Forrás:

WebClient.cs

Feltölti a megadott név/érték gyűjtemény adatait a megadott URI által azonosított erőforrásba. Ez a metódus nem blokkolja a hívó szálat.

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync(Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

Paraméterek

address

Uri

A gyűjtemény fogadásához tartozó erőforrás URI-ja. Ennek az URI-nak azonosítania kell egy erőforrást, amely fogadni tudja az alapértelmezett módszerrel küldött kérést.

data

NameValueCollection

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

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 metódus sztringet küld egy erőforrásnak. 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 sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ha értesítést szeretne kapni a sztringfeltöltés befejezéséről, hozzáadhat egy eseménykezelőt az UploadStringCompleted eseményhez.

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

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 UploadValues(Uri, NameValueCollection)kiadott kivételeket: .

UploadValuesAsync(Uri, String, NameValueCollection)

Forrás:

WebClient.cs

Feltölti a megadott név/érték gyűjtemény adatait a megadott URI által azonosított erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

Paraméterek

address

Uri

A gyűjtemény fogadásához tartozó erőforrás URI-ja. Ennek az URI-nak azonosítania kell egy erőforrást, amely képes elfogadni a metódussal küldött kérést method .

method

String

A sztring erőforrásba való küldéséhez használt módszer. 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ő.

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-

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

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 elküldi az erőforrásnak az NameValueCollection egy address adott fájlban lévő adatokat. Ezzel a módszerrel űrlapadatokat küldhet egy URI-nak feldolgozás céljából. Az adatokat az űrlap-urlencoded médiatípus használatával küldi el a rendszer; a Content-Type fejléc értékét "application/x-www-form-urlencoded" értékre kell állítani. A fejléc alapértelmezés szerint helyesen van beállítva. A UploadValuesAsync metódusok akkor adnak egy WebException hibát, ha ezt a metódust egy másik tartalomtípusú fejlécértékkel hívja meg a Headers gyűjteményben.

Ha a metódust method 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.

A NameValueCollection rendszer aszinkron módon küldi el a szálerőforrásokat, amelyeket a rendszer automatikusan lefoglal a szálkészletből. Ha értesítést szeretne kapni a feltöltési művelet befejeződésekor, adjon hozzá egy eseménykezelőt az UploadValuesCompleted eseményhez.

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

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, 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 a .NET Frameworkben.

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 UploadValues(Uri, String, NameValueCollection)kiadott kivételeket: .

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Forrás:

WebClient.cs

Feltölti a megadott név/érték gyűjtemény adatait a megadott URI által azonosított erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat, és lehetővé teszi, hogy a hívó átadjon egy objektumot a művelet befejezésekor meghívott metódusnak.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);

public void UploadValuesAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

Paraméterek

address

Uri

A gyűjtemény fogadásához tartozó erőforrás URI-ja. Ennek az URI-nak azonosítania kell egy erőforrást, amely képes elfogadni a metódussal küldött kérést method .

method

String

A sztring 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

NameValueCollection

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

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: .

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

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

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 elküldi az erőforrásnak az NameValueCollection egy address adott fájlban lévő adatokat. Ezzel a módszerrel űrlapadatokat küldhet egy URI-nak feldolgozás céljából. Az adatokat az űrlap-urlencoded médiatípus használatával küldi el a rendszer; a Content-Type fejléc értékét "application/x-www-form-urlencoded" értékre kell állítani. A fejléc alapértelmezés szerint helyesen van beállítva. A UploadValuesAsync metódusok akkor adnak egy WebException hibát, ha ezt a metódust egy másik tartalomtípusú fejlécértékkel hívja meg a Headers gyűjteményben.

Ha a metódust method 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.

A NameValueCollection rendszer aszinkron módon küldi el a szálerőforrásokat, amelyeket a rendszer automatikusan lefoglal a szálkészletből. Ha értesítést szeretne kapni a feltöltési művelet befejeződésekor, adjon hozzá egy eseménykezelőt az UploadValuesCompleted eseményhez.

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

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, 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 a .NET Frameworkben.