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 úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream objekt použitý ke čtení dat ze zdroje.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

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 operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po otevření datového proudu pro čtení datového prostředku. Tato metoda neblokuje volající vlákno při otevírání datového proudu.

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.

Poznámka

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

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.

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 úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream objekt použitý ke čtení dat ze zdroje.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

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 operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po otevření datového proudu pro čtení datového prostředku. Tato metoda neblokuje volající vlákno při otevírání datového proudu.

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.

Poznámka

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

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.

Viz také

• Stream