WebClient.UploadDataAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

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

Přetížení

UploadDataAsync(Uri, String, Byte[])	Odešle datovou vyrovnávací paměť do prostředku identifikovaného identifikátorem URI pomocí zadané metody. Tato metoda neblokuje volající vlákno.
UploadDataAsync(Uri, String, Byte[], Object)	Nahraje datovou vyrovnávací paměť do prostředku identifikovaného identifikátorem URI pomocí zadané metody a identifikačního tokenu.
UploadDataAsync(Uri, Byte[])	Nahraje datovou vyrovnávací paměť 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

Odešle datovou vyrovnávací paměť 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[]

Datová vyrovnávací paměť, 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, nepřišla žádná odpověď.

Poznámky

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

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

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí se jednat o 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.

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.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem UploadData(Uri, String, Byte[]).

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

Zdroj:

WebClient.cs

Nahraje datovou vyrovnávací paměť do prostředku identifikovaného identifikátorem URI pomocí zadané metody a identifikačního 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[]

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

userToken

Object

Uživatelem definovaný objekt, který je předán metodě vyvolány 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, nepřišla žádná odpověď.

Poznámky

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

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

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí se jednat o 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.

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.

UploadDataAsync(Uri, Byte[])

Zdroj:

WebClient.cs

Nahraje datovou vyrovnávací paměť 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[]

Datová vyrovnávací paměť, 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, nepřišla žádná odpověď.

Poznámky

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

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

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí se jednat o 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.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem UploadData(Uri, Byte[]).