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

Caution

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 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.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .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

Caution

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 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.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .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

Caution

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 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.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .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

Caution

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 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.

Note

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