Sdílet prostřednictvím

WebClient.UploadValuesAsync Metoda

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.WebClient.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI. Tyto metody neblokují volající vlákno.

Přetížení

UploadValuesAsync(Uri, NameValueCollection)

Nahraje data v zadané kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno.
UploadValuesAsync(Uri, String, NameValueCollection)

Nahraje data v zadané kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody. Tato metoda neblokuje volající vlákno.
UploadValuesAsync(Uri, String, NameValueCollection, Object)

Nahraje data v zadané kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody. Tato metoda neblokuje volající vlákno a umožňuje volající předat objekt metodě, která je vyvolána při dokončení operace.

UploadValuesAsync(Uri, NameValueCollection)

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Nahraje data v zadané kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno.

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)

Parametry

address
Uri

Identifikátor URI prostředku pro příjem kolekce. Tento identifikátor URI musí identifikovat prostředek, který může přijmout požadavek odeslaný pomocí výchozí metody.

data
NameValueCollection

NameValueCollection odeslat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato metoda odešle řetězec do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Pokud chcete dostávat oznámení po dokončení nahrávání řetězce, můžete do události UploadStringCompleted přidat obslužnou rutinu události.

Tato metoda neblokuje volající vlákno při odesílání řetězce. Pokud chcete odeslat řetězec a blok při čekání na odpověď serveru, použijte jednu z metod UploadString.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se použije metoda POST.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané UploadValues(Uri, NameValueCollection).

Platí pro

UploadValuesAsync(Uri, String, NameValueCollection)

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Nahraje data v zadané kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody. Tato metoda neblokuje volající vlákno.

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

Parametry

address
Uri

Identifikátor URI prostředku pro příjem kolekce. Tento identifikátor URI musí identifikovat prostředek, který může přijmout požadavek odeslaný metodou method.

method
String

Metoda použitá k odeslání řetězce do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data
NameValueCollection

NameValueCollection odeslat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

-nebo-

method nelze použít k odesílání obsahu.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato metoda odešle data obsažená v NameValueCollection do address prostředku. Tato metoda slouží k odesílání dat formuláře do identifikátoru URI ke zpracování. Data se odesílají pomocí typu média s kódem form-urlencoded; Hodnota hlavičky Content-Type musí být nastavená na "application/x-www-form-urlencoded". Záhlaví je ve výchozím nastavení správně nastavené. Metody UploadValuesAsync vyvolá WebException, pokud tuto metodu zavoláte s jinou hodnotou hlavičky Content-Type nastavenou v kolekci Headers.

Pokud method metoda není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

NameValueCollection se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Pokud chcete dostávat oznámení po dokončení operace nahrávání, přidejte obslužnou rutinu události do události UploadValuesCompleted.

Tato metoda neblokuje volající vlákno při odesílání řetězce. Pokud chcete odeslat řetězec a blok při čekání na odpověď serveru, použijte jednu z metod UploadValues.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdná, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané UploadValues(Uri, String, NameValueCollection).

Platí pro

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Nahraje data v zadané kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI pomocí zadané metody. Tato metoda neblokuje volající vlákno a umožňuje volající předat objekt metodě, která je vyvolána při dokončení operace.

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

Parametry

address
Uri

Identifikátor URI prostředku pro příjem kolekce. Tento identifikátor URI musí identifikovat prostředek, který může přijmout požadavek odeslaný metodou method.

method
String

Metoda HTTP použitá k odeslání řetězce do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data
NameValueCollection

NameValueCollection odeslat do prostředku.

userToken
Object

Uživatelem definovaný objekt, který se předá metodě vyvolá při dokončení asynchronní operace.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

-nebo-

method nelze použít k odesílání obsahu.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato metoda odešle data obsažená v NameValueCollection do address prostředku. Tato metoda slouží k odesílání dat formuláře do identifikátoru URI ke zpracování. Data se odesílají pomocí typu média s kódem form-urlencoded; Hodnota hlavičky Content-Type musí být nastavená na "application/x-www-form-urlencoded". Záhlaví je ve výchozím nastavení správně nastavené. Metody UploadValuesAsync vyvolá WebException, pokud tuto metodu zavoláte s jinou hodnotou hlavičky Content-Type nastavenou v kolekci Headers.

Pokud method metoda není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

NameValueCollection se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Pokud chcete dostávat oznámení po dokončení operace nahrávání, přidejte obslužnou rutinu události do události UploadValuesCompleted.

Tato metoda neblokuje volající vlákno při odesílání řetězce. Pokud chcete odeslat řetězec a blok při čekání na odpověď serveru, použijte jednu z metod UploadValues.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdná, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro