WebClient.UploadValuesAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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ázvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno. |
UploadValuesAsync(Uri, String, NameValueCollection) |
Pomocí zadané metody nahraje data v zadané kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno. |
UploadValuesAsync(Uri, String, NameValueCollection, Object) |
Pomocí zadané metody nahraje data v zadané kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno a umožňuje volajícímu 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 názvů a hodnot 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
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 UploadString metod .
V rozhraní .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 nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem UploadValues(Uri, NameValueCollection).
Platí pro
UploadValuesAsync(Uri, String, NameValueCollection)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Pomocí zadané metody nahraje data v zadané kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI. 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, 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 null, výchozí hodnota je POST pro http a STOR pro ftp.
- data
- NameValueCollection
Odešle NameValueCollection se do prostředku.
Výjimky
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 odeslání obsahu.
Poznámky
Tato metoda odešle data obsažená v objektu address
do NameValueCollection 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". Hlavička 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 protokolů určují, co se stane. Obvykle WebException je vyvolán s vlastností nastavenou Status k označení chyby.
Se NameValueCollection 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 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 UploadValues metod .
V rozhraní .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 nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem 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 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);
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 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 při dokončení asynchronní operace.
Výjimky
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 odeslá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.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro