WebClient.DownloadStringTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Stáhne prostředek jako String identifikátor URI zadaný jako asynchronní operace pomocí objektu úkolu. Tyto metody neblokují volající vlákno.

Přetížení

Name	Description
DownloadStringTaskAsync(String)	Stáhne prostředek jako String identifikátor URI zadaný jako asynchronní operace pomocí objektu úkolu.
DownloadStringTaskAsync(Uri)	Stáhne prostředek jako String identifikátor URI zadaný jako asynchronní operace pomocí objektu úkolu.

DownloadStringTaskAsync(String)

Zdroj:

WebClient.cs

Stáhne prostředek jako String identifikátor URI zadaný jako asynchronní operace pomocí objektu úkolu.

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í 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. 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žívá kódování zadané ve Encoding vlastnosti 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 CancelAsync metody.

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.

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 identifikátor URI zadaný jako asynchronní operace pomocí objektu úkolu.

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í 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. 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žívá kódování zadané ve Encoding vlastnosti 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 CancelAsync metody.

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.

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.