WebClient.UploadValuesAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.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 názvu nebo hodnoty 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 názvů a hodnot 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 názvů a hodnot 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ímu předat objekt metodě, která je vyvolána po dokončení operace.

UploadValuesAsync(Uri, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje data v zadané kolekci názvu nebo hodnoty 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, který má kolekci přijmout. Tento identifikátor URI musí identifikovat prostředek, který může přijmout požadavek odeslaný pomocí výchozí metody.

data

NameValueCollection

Odešle NameValueCollection se 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, nepřišla žádná odpověď.

Poznámky

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 ho tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti. Pokud chcete dostávat oznámení o dokončení nahrání řetězce, můžete do události přidat obslužnou rutinu UploadStringCompleted události.

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

V rozhraních .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud 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žívá metoda POST.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem UploadValues(Uri, NameValueCollection).

UploadValuesAsync(Uri, String, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje data v zadané kolekci názvů a hodnot 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);

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, který má kolekci přijmout. 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 je null, výchozí hodnota je POST pro http a STOR pro ftp.

data

NameValueCollection

Odešle NameValueCollection se 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, nepřišla žádná odpověď.

-nebo-

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

Poznámky

Tato metoda odesílá data obsažená v objektu NameValueCollectionaddress do prostředku. Tato metoda slouží k odeslání dat formuláře do identifikátoru URI ke zpracování. Data se odesílají pomocí media typu 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 zavoláte tuto metodu s jinou hodnotou hlavičky Content-Type nastavenou v kolekci Headers .

method Pokud metoda není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle WebException je vyvolán s vlastností nastavenou Status pro označení chyby.

Objekt 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í o dokončení operace nahrávání, přidejte do události obslužnou rutinu UploadValuesCompleted události.

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

V rozhraních .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdná, připojí se k address.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem UploadValues(Uri, String, NameValueCollection).

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Zdroj:

WebClient.cs

Nahraje data v zadané kolekci názvů a hodnot 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ímu předat objekt metodě, která je vyvolána po 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);

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, který má kolekci přijmout. 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 je null, výchozí hodnota je POST pro http a STOR pro ftp.

data

NameValueCollection

Odešle NameValueCollection se do prostředku.

userToken

Object

Uživatelem definovaný objekt, který je předán metodě vyvolány po 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, nepřišla žádná odpověď.

-nebo-

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

Poznámky

Tato metoda odesílá data obsažená v objektu NameValueCollectionaddress do prostředku. Tato metoda slouží k odeslání dat formuláře do identifikátoru URI ke zpracování. Data se odesílají pomocí media typu 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 zavoláte tuto metodu s jinou hodnotou hlavičky Content-Type nastavenou v kolekci Headers .

method Pokud metoda není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle WebException je vyvolán s vlastností nastavenou Status pro označení chyby.

Objekt 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í o dokončení operace nahrávání, přidejte do události obslužnou rutinu UploadValuesCompleted události.

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

V rozhraních .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdná, připojí se k address.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.