WebClient.UploadValuesTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy. Tyto metody neblokují volající vlákno.

Přetížení

UploadValuesTaskAsync(String, String, NameValueCollection)	Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.
UploadValuesTaskAsync(String, NameValueCollection)	Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.
UploadValuesTaskAsync(Uri, NameValueCollection)	Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.
UploadValuesTaskAsync(Uri, String, NameValueCollection)	Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.

UploadValuesTaskAsync(String, String, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())

Parametry

address

String

Identifikátor URI prostředku pro příjem kolekce.

method

String

Metoda HTTP použitá k odeslání kolekce 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.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

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

-nebo-

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

-nebo-

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

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

Hlavička Content-type není null ani application/x-www-form-urlencoded.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání kolekce name/value do prostředku. Kolekce název/hodnota se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Pokud je hlavička Content-type null, tato metoda ji nastaví na "application/x-www-form-urlencoded".

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.

UploadValuesTaskAsync(String, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())

Parametry

address

String

Identifikátor URI prostředku pro příjem kolekce.

data

NameValueCollection

NameValueCollection odeslat do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

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

-nebo-

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

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

Hlavička Content-type není null ani application/x-www-form-urlencoded.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání kolekce name/value do prostředku. Kolekce název/hodnota se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Pokud je hlavička Content-type null, tato metoda ji nastaví na "application/x-www-form-urlencoded".

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.

UploadValuesTaskAsync(Uri, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

Parametry

address

Uri

Identifikátor URI prostředku pro příjem kolekce.

data

NameValueCollection

NameValueCollection odeslat do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

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

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

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

-nebo-

Hodnota záhlaví Content-type není null a není application/x-www-form-urlencoded.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání kolekce name/value do prostředku. Kolekce název/hodnota se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Pokud je hlavička Content-type null, tato metoda ji nastaví na "application/x-www-form-urlencoded".

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.

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje zadanou kolekci name/value do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())

Parametry

address

Uri

Identifikátor URI prostředku pro příjem kolekce.

method

String

Metoda HTTP použitá k odeslání kolekce 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.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

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

-nebo-

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

-nebo-

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

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

Hlavička Content-type není null ani application/x-www-form-urlencoded.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání kolekce name/value do prostředku. Kolekce název/hodnota se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Pokud je hlavička Content-type null, tato metoda ji nastaví na "application/x-www-form-urlencoded".

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.