WebClient.DownloadStringAsync 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í.
Přetížení
DownloadStringAsync(Uri) |
Stáhne prostředek zadaný jako Uri. Tato metoda neblokuje volající vlákno. |
DownloadStringAsync(Uri, Object) |
Stáhne zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno. |
DownloadStringAsync(Uri)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne prostředek zadaný jako Uri. Tato metoda neblokuje volající vlákno.
public:
void DownloadStringAsync(Uri ^ address);
public void DownloadStringAsync (Uri address);
member this.DownloadStringAsync : Uri -> unit
Public Sub DownloadStringAsync (address As Uri)
Parametry
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
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. Pokud chcete stáhnout prostředek a blokovat při čekání na odpověď serveru, použijte metodu DownloadString . Po dokončení DownloadStringCompleted stahování se vyvolá událost. Aby vaše aplikace obdržela oznámení, musí tuto událost zpracovat. Stažený řetězec je k dispozici ve Result vlastnosti.
V rozhraních .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 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.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem DownloadString(Uri).
Platí pro
DownloadStringAsync(Uri, Object)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno.
public:
void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);
public void DownloadStringAsync (Uri address, object? userToken);
public void DownloadStringAsync (Uri address, object userToken);
member this.DownloadStringAsync : Uri * obj -> unit
Public Sub DownloadStringAsync (address As Uri, userToken As Object)
Parametry
- userToken
- Object
Uživatelem definovaný objekt, který je předán metodě vyvolány po dokončení asynchronní operace.
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
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. Pokud chcete stáhnout prostředek a blokovat při čekání na odpověď serveru, použijte metodu DownloadString . Po dokončení DownloadStringCompleted stahování se vyvolá událost. Aby vaše aplikace obdržela oznámení, musí tuto událost zpracovat. Stažený řetězec je k dispozici ve Result vlastnosti.
V rozhraních .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 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