WebClient.UploadDataAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI. Tato metoda neblokuje volající vlákno.

Přetížení

UploadDataAsync(Uri, String, Byte[])	Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI pomocí zadané metody. Tato metoda neblokuje volající vlákno.
UploadDataAsync(Uri, String, Byte[], Object)	Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI pomocí zadané metody a identifikace tokenu.
UploadDataAsync(Uri, Byte[])	Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI pomocí metody POST. Tato metoda neblokuje volající vlákno.

UploadDataAsync(Uri, String, Byte[])

Zdroj:

WebClient.cs

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI pomocí zadané metody. Tato metoda neblokuje volající vlákno.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, string? method, byte[] data);

member this.UploadDataAsync : Uri * string * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte())

Parametry

address

Uri

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

method

String

Metoda použitá k odeslání dat do prostředku. Pokud null, výchozí hodnota je POST pro http a STOR pro ftp.

data

Byte[]

Vyrovnávací paměť dat, která se má odeslat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a 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ěď.

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 metoda odešle do prostředku vyrovnávací paměť dat. Vyrovnávací paměť dat se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Data nejsou zakódována. Pokud chcete dostávat oznámení po dokončení nahrávání dat, přidejte do události UploadDataCompleted obslužnou rutinu události.

Tato metoda neblokuje volající vlákno při odesílání dat. Pokud chcete odesílat data a blokovat při čekání na odpověď serveru, použijte jednu z metod UploadData.

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

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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané UploadData(Uri, String, Byte[]).

UploadDataAsync(Uri, String, Byte[], Object)

Zdroj:

WebClient.cs

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI pomocí zadané metody a identifikace tokenu.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);

public void UploadDataAsync (Uri address, string? method, byte[] data, object? userToken);

member this.UploadDataAsync : Uri * string * byte[] * obj -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)

Parametry

address

Uri

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

method

String

Metoda použitá k odeslání dat do prostředku. Pokud null, výchozí hodnota je POST pro http a STOR pro ftp.

data

Byte[]

Vyrovnávací paměť dat, která se má odeslat do prostředku.

userToken

Object

Uživatelem definovaný objekt, který se předá metodě vyvolá při dokončení asynchronní operace.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a 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ěď.

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 metoda odešle do prostředku vyrovnávací paměť dat. Vyrovnávací paměť dat se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Data nejsou zakódována. Pokud chcete dostávat oznámení po dokončení nahrávání dat, přidejte do události UploadDataCompleted obslužnou rutinu události.

Tato metoda neblokuje volající vlákno při odesílání dat. Pokud chcete odesílat data a blokovat při čekání na odpověď serveru, použijte jednu z metod UploadData.

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

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.

UploadDataAsync(Uri, Byte[])

Zdroj:

WebClient.cs

Nahraje vyrovnávací paměť dat do prostředku identifikovaného identifikátorem URI pomocí metody POST. Tato metoda neblokuje volající vlákno.

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, byte[] data);

member this.UploadDataAsync : Uri * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, data As Byte())

Parametry

address

Uri

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

data

Byte[]

Vyrovnávací paměť dat, která se má odeslat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a 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ěď.

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 metoda odešle do prostředku vyrovnávací paměť dat. Vyrovnávací paměť dat se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Data nejsou zakódována. Pokud chcete dostávat oznámení po dokončení nahrávání dat, přidejte do události UploadDataCompleted obslužnou rutinu události.

Tato metoda neblokuje volající vlákno při odesílání dat. Pokud chcete odesílat data a blokovat při čekání na odpověď serveru, použijte jednu z metod UploadData.

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 vlastnost BaseAddress není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován s BaseAddress, aby se vytvořil absolutní identifikátor 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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané UploadData(Uri, Byte[]).