WebClient.DownloadDataTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Stáhne prostředek jako Byte pole 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 Byte pole z identifikátoru URI zadaného jako asynchronní operace pomocí objektu úlohy.
DownloadDataTaskAsync(Uri)	Stáhne prostředek jako Byte pole z identifikátoru URI zadaného jako asynchronní operace pomocí objektu úlohy.

DownloadDataTaskAsync(String)

Zdroj:

WebClient.cs

Stáhne prostředek jako Byte pole 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 ke stažení.

Návraty

Task<Byte[]>

Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole 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

Tato operace nebude blokována. Task<TResult> Vrácený 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ý ke schématu identifikátoru URI zadanému v parametru address . Data se stahují asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

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.

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 ú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 ke stažení.

Návraty

Task<Byte[]>

Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole 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

Tato operace nebude blokována. Task<TResult> Vrácený 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ý ke schématu identifikátoru URI zadanému v parametru address . Data se stahují asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

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.