WebClient.UploadValuesTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, 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í

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

Odeslání NameValueCollection do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole 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 nebo "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 CancelAsync metody.

Pokud základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. WebException Obvykle je vyvolán s Status vlastností nastavenou na indikaci chyby.

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen 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

Odeslání NameValueCollection do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole 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 nebo "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 CancelAsync metody.

Pokud základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. WebException Obvykle je vyvolán s Status vlastností nastavenou na indikaci chyby.

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen 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

Odeslání NameValueCollection do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole 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 Content-type záhlaví 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 CancelAsync metody.

Pokud základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. WebException Obvykle je vyvolán s Status vlastností nastavenou na indikaci chyby.

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen 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

Odeslání NameValueCollection do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole 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 nebo "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 CancelAsync metody.

Pokud základní požadavek server nerozumí, základní třídy protokolu určují, co se stane. WebException Obvykle je vyvolán s Status vlastností nastavenou na indikaci chyby.

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen 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.