WebClient.DownloadStringTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

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

DownloadStringTaskAsync(String)

Zdroj:

WebClient.cs

Stáhne prostředek jako z identifikátoru String 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 ke stažení.

Návraty

Task<String>

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

Po stažení prostředku tato metoda použije 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é se nedokončily, voláním CancelAsync metody .

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.

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.

DownloadStringTaskAsync(Uri)

Zdroj:

WebClient.cs

Stáhne prostředek jako z identifikátoru String 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 ke stažení.

Návraty

Task<String>

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

Po stažení prostředku tato metoda použije 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é se nedokončily, voláním CancelAsync metody .

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.

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.