WebClient.OpenReadTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úkolu. Tyto metody neblokují volající vlákno.

Přetížení

Name	Description
OpenReadTaskAsync(String)	Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úkolu.
OpenReadTaskAsync(Uri)	Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úkolu.

OpenReadTaskAsync(String)

Zdroj:

WebClient.cs

Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);

member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Parametry

address

String

Identifikátor URI prostředku, který se má načíst.

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci. Result Vlastnost objektu úkolu vrátí Stream použitou ke čtení dat z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a adresou 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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po otevření čitelného datového proudu do datového prostředku. Tato metoda neblokuje volající vlákno při otevření datového proudu.

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.

Poznámka

Až skončíte, musíte zavolat Stream.Close , abyste se vyhnuli výpadku Stream systémových prostředků.

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 nezadá absolutní identifikátor URI, musí být relativní identifikátor URI, address který je zkombinován s BaseAddress cílem vytvořit absolutní identifikátor URI požadovaného prostředku. QueryString Pokud 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.

Viz také

• Stream

OpenReadTaskAsync(Uri)

Zdroj:

WebClient.cs

Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);

member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Parametry

address

Uri

Identifikátor URI prostředku, který se má načíst.

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci. Result Vlastnost objektu úkolu vrátí Stream použitou ke čtení dat z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a adresou 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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po otevření čitelného datového proudu do datového prostředku. Tato metoda neblokuje volající vlákno při otevření datového proudu.

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.

Poznámka

Až skončíte, musíte zavolat Stream.Close , abyste se vyhnuli výpadku Stream systémových prostředků.

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 nezadá absolutní identifikátor URI, musí být relativní identifikátor URI, address který je zkombinován s BaseAddress cílem vytvořit absolutní identifikátor URI požadovaného prostředku. QueryString Pokud 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.

Viz také

• Stream