WebClient.DownloadStringTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

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

Přetížení

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

DownloadStringTaskAsync(String)

Zdroj:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);

member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As String) As Task(Of String)

Parametry

address

String

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

Návraty

Task<String>

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. Prostředek se stáhne asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Po stažení prostředku tato metoda použije kódování zadané ve vlastnosti Encoding k převodu prostředku na String. Tato metoda neblokuje volající vlákno při stahování prostředku.

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

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.

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.

DownloadStringTaskAsync(Uri)

Zdroj:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);

member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)

Parametry

address

Uri

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

Návraty

Task<String>

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. Prostředek se stáhne asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Po stažení prostředku tato metoda použije kódování zadané ve vlastnosti Encoding k převodu prostředku na String. Tato metoda neblokuje volající vlákno při stahování prostředku.

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

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.

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.