WebClient.OpenReadTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

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í

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. Vlastnost Result objektu úkolu vrátí Stream sloužící ke čtení dat z prostředku.

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 operace nebude blokovat. Vrácený objekt Task<TResult> 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

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku 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 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.

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. Vlastnost Result objektu úkolu vrátí Stream sloužící ke čtení dat z prostředku.

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 operace nebude blokovat. Vrácený objekt Task<TResult> 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

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku 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 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.

Viz také

• Stream