WebClient.UploadValuesTaskAsync 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 jako asynchronní operaci pomocí objektu úlohy. Tyto metody neblokují volající vlákno.

Přetížení

UploadValuesTaskAsync(String, String, NameValueCollection)	Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.
UploadValuesTaskAsync(String, NameValueCollection)	Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.
UploadValuesTaskAsync(Uri, NameValueCollection)	Nahraje zadanou kolekci názvů a hodnot do prostředku identifikovaného zadaným identifikátorem URI jako asynchronní operaci pomocí objektu úlohy.
UploadValuesTaskAsync(Uri, String, NameValueCollection)	Nahraje zadanou kolekci názvů a hodnot 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 názvů a hodnot 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, který má kolekci přijmout.

method

String

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

Návraty

Task<Byte[]>

Objekt úlohy 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, nepřišla žádná odpověď.

-nebo-

Při otevírání streamu došlo k chybě.

-nebo-

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

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po nahrání kolekce názvů a hodnot do prostředku. Kolekce názvů a hodnot se odesílá asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

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 .

Pokud server nerozumějí podkladovému požadavku, určí, co se stane, třídy podkladových protokolů. Obvykle WebException je vyvolán s vlastností nastavenou Status pro označení 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, 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.

UploadValuesTaskAsync(String, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje zadanou kolekci názvů a hodnot 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, který má kolekci přijmout.

data

NameValueCollection

Odešle NameValueCollection se do prostředku.

Návraty

Task<Byte[]>

Objekt úlohy 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, nepřišla žádná odpověď.

-nebo-

Při otevírání streamu došlo k chybě.

-nebo-

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

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po nahrání kolekce názvů a hodnot do prostředku. Kolekce názvů a hodnot se odesílá asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

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 .

Pokud server nerozumějí podkladovému požadavku, určí, co se stane, třídy podkladových protokolů. Obvykle WebException je vyvolán s vlastností nastavenou Status pro označení 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, 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.

UploadValuesTaskAsync(Uri, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje zadanou kolekci názvů a hodnot 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, který má kolekci přijmout.

data

NameValueCollection

Odešle NameValueCollection se do prostředku.

Návraty

Task<Byte[]>

Objekt úlohy 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í streamu došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.

-nebo-

Hodnota Content-type hlavičky není null a není application/x-www-form-urlencoded.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po nahrání kolekce názvů a hodnot do prostředku. Kolekce názvů a hodnot se odesílá asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

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 .

Pokud server nerozumějí podkladovému požadavku, určí, co se stane, třídy podkladových protokolů. Obvykle WebException je vyvolán s vlastností nastavenou Status pro označení 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, 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.

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Zdroj:

WebClient.cs

Nahraje zadanou kolekci názvů a hodnot 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, který má kolekci přijmout.

method

String

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

Návraty

Task<Byte[]>

Objekt úlohy 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, nepřišla žádná odpověď.

-nebo-

Při otevírání streamu došlo k chybě.

-nebo-

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

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po nahrání kolekce názvů a hodnot do prostředku. Kolekce názvů a hodnot se odesílá asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

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 .

Pokud server nerozumějí podkladovému požadavku, určí, co se stane, třídy podkladových protokolů. Obvykle WebException je vyvolán s vlastností nastavenou Status pro označení 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, 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.