WebClient.OpenReadAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

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

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

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a adresy je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

-nebo-

Při otevírání datového proudu 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 metoda načte Stream instanci použitou pro přístup k prostředku určenému parametrem address. Stream se získá pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení, když je stream k dispozici, přidejte do události OpenReadCompleted obslužnou rutinu události.

Poznámka

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku systémových prostředků.

Tato metoda neblokuje volající vlákno při otevření datového proudu. Pokud chcete blokovat čekání na datový proud, použijte metodu OpenReadAsync.

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 vlastnost BaseAddress není prázdný řetězec ("") a address nezadá 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ého prostředku. Pokud QueryString vlastnost není null, je připojena k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

Poznámka

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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané OpenRead(Uri).

OpenReadAsync(Uri, Object)

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);

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ý se předá metodě vyvolá při dokončení asynchronní operace.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a adresy je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

-nebo-

Při otevírání datového proudu 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 metoda načte Stream instanci použitou pro přístup k prostředku určenému parametrem address. Stream se získá pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení, když je stream k dispozici, přidejte do události OpenReadCompleted obslužnou rutinu události.

Poznámka

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku systémových prostředků.

Tato metoda neblokuje volající vlákno při otevření datového proudu. Pokud chcete blokovat čekání na datový proud, použijte metodu OpenRead.

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 vlastnost BaseAddress není prázdný řetězec ("") a address nezadá 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ého prostředku. Pokud QueryString vlastnost není null, je připojena k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

Poznámka

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.