WebClient.DownloadDataTaskAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- Zdroj:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole obsahující stažený prostředek.
- Atributy
Výjimky
Parametr address
je null
.
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ý k schématu identifikátoru URI zadanému v parametru address
. Data se stahují asynchronně pomocí prostředků vláken, 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, 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 ke stažení prostředku FTP používá příkaz RETR. 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 vyžaduje data ze serveru a zobrazí vrácená data. Předpokládá, že remoteUri
obsahuje platný identifikátor URI pro požadovaná data.
Platí pro
DownloadDataTaskAsync(Uri)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Byte pole obsahující stažený prostředek.
- Atributy
Výjimky
Parametr address
je null
.
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ý k schématu identifikátoru URI zadanému v parametru address
. Data se stahují asynchronně pomocí prostředků vláken, 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, 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 ke stažení prostředku FTP používá příkaz RETR. 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.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro