WebClient.DownloadDataTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

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

Přetížení

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

DownloadDataTaskAsync(String)

Zdroj:

WebClient.cs

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

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í Byte pole obsahující stažený zdroj.

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.

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 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á, že remoteUri obsahuje platný identifikátor URI pro požadovaná data.

DownloadDataTaskAsync(Uri)

Zdroj:

WebClient.cs

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

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í Byte pole obsahující stažený zdroj.

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.

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