WebClient.OpenReadAsync 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í.
Otevře čitelný datový proud obsahující zadaný prostředek. Tyto metody neblokují volající vlákno.
Přetížení
OpenReadAsync(Uri) |
Otevře čitelný datový proud obsahující zadaný prostředek. Tato metoda neblokuje volající vlákno. |
OpenReadAsync(Uri, Object) |
Otevře čitelný datový proud obsahující zadaný prostředek. Tato metoda neblokuje volající vlákno. |
OpenReadAsync(Uri)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Otevře čitelný datový proud obsahující zadaný prostředek. Tato metoda neblokuje volající vlákno.
public:
void OpenReadAsync(Uri ^ address);
public void OpenReadAsync (Uri address);
member this.OpenReadAsync : Uri -> unit
Public Sub OpenReadAsync (address As Uri)
Parametry
- address
- Uri
Identifikátor URI prostředku, který se má načíst.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddress a adresa je neplatný.
-nebo-
Při stahování prostředku došlo k chybě.
-nebo-
Při otevírání streamu došlo k chybě.
Poznámky
Tato metoda načte Stream instanci používanou pro přístup k prostředku určenému parametrem address
. Datový proud se získává pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení o dostupnosti datového proudu, přidejte do události obslužnou rutinu OpenReadCompleted události.
Poznámka
Až skončíte s Stream nástrojem, musíte volatStream.Close, abyste se vyhnuli výpadku systémových prostředků.
Tato metoda neblokuje volající vlákno při otevírání datového proudu. Pokud chcete blokovat při čekání na datový proud, použijte metodu OpenReadAsync .
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
neurčuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby se vytvořil absolutní identifikátor URI požadovaného prostředku. Pokud vlastnost QueryString není null
, 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 OpenRead(Uri).
Platí pro
OpenReadAsync(Uri, Object)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Otevře čitelný datový proud obsahující zadaný prostředek. Tato metoda neblokuje volající vlákno.
public:
void OpenReadAsync(Uri ^ address, System::Object ^ userToken);
public void OpenReadAsync (Uri address, object? userToken);
public void OpenReadAsync (Uri address, object userToken);
member this.OpenReadAsync : Uri * obj -> unit
Public Sub OpenReadAsync (address As Uri, userToken As Object)
Parametry
- address
- Uri
Identifikátor URI prostředku, který se má načíst.
- 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 adresa je neplatný.
-nebo-
Při stahování prostředku došlo k chybě.
-nebo-
Při otevírání streamu došlo k chybě.
Poznámky
Tato metoda načte Stream instanci používanou pro přístup k prostředku určenému parametrem address
. Datový proud se získává pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení o dostupnosti datového proudu, přidejte do události obslužnou rutinu OpenReadCompleted události.
Poznámka
Až skončíte s Stream nástrojem, musíte volatStream.Close, abyste se vyhnuli výpadku systémových prostředků.
Tato metoda neblokuje volající vlákno při otevírání datového proudu. Pokud chcete blokovat při čekání na datový proud, použijte metodu OpenRead .
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
neurčuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby se vytvořil absolutní identifikátor URI požadovaného prostředku. Pokud vlastnost QueryString není null
, 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