WebClient.DownloadDataTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Stáhne prostředek jako pole Byte z identifikátoru URI zadaného jako asynchronní operace pomocí objektu úlohy. Tyto metody neblokují volající vlákno.

Přetížení

DownloadDataTaskAsync(String)	Stáhne prostředek jako pole Byte z identifikátoru URI zadaného jako asynchronní operace pomocí objektu úlohy.
DownloadDataTaskAsync(Uri)	Stáhne prostředek jako pole Byte z identifikátoru URI zadaného jako asynchronní operace pomocí objektu úlohy.

DownloadDataTaskAsync(String)

Zdroj:

WebClient.cs

Stáhne prostředek jako pole Byte z identifikátoru URI zadaného jako asynchronní operace pomocí objektu úlohy.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);

member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())

Parametry

address

String

Identifikátor URI prostředku, který chcete stáhnout.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující stažený prostředek.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

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 stažení datového prostředku.

Tato metoda načte zadaný prostředek pomocí výchozí metody pro protokol přidružený k schématu identifikátoru URI zadanému v parametru address. Data se stáhnou asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

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.

Následující příklad kódu požaduje data ze serveru a zobrazí vrácená data. Předpokládá se, že remoteUri obsahuje platný identifikátor URI pro požadovaná data.

DownloadDataTaskAsync(Uri)

Zdroj:

WebClient.cs

Stáhne prostředek jako pole Byte z identifikátoru URI zadaného jako asynchronní operace pomocí objektu úlohy.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);

member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())

Parametry

address

Uri

Identifikátor URI prostředku, který chcete stáhnout.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující stažený prostředek.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

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 stažení datového prostředku.

Tato metoda načte zadaný prostředek pomocí výchozí metody pro protokol přidružený k schématu identifikátoru URI zadanému v parametru address. Data se stáhnou asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

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.