WebClient.OpenReadTaskAsync 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 jako asynchronní operaci pomocí objektu úlohy. 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 úlohy. |
OpenReadTaskAsync(Uri) |
Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úlohy. |
OpenReadTaskAsync(String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úlohy.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream objekt použitý ke čtení dat ze zdroje.
- Atributy
Výjimky
Parametr address
je null
.
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
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áken, které jsou automaticky přiděleny z fondu vláken.
Poznámka
Až skončíte s Stream funkcí , musíte ji volatStream.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é 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í to být relativní identifikátor URI, který se kombinuje sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaného prostředku. Pokud vlastnost QueryString není null
, připojí se 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 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é
Platí pro
OpenReadTaskAsync(Uri)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Otevře čitelný datový proud obsahující zadaný prostředek jako asynchronní operaci pomocí objektu úlohy.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream objekt použitý ke čtení dat ze zdroje.
- Atributy
Výjimky
Parametr address
je null
.
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
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áken, které jsou automaticky přiděleny z fondu vláken.
Poznámka
Až skončíte s Stream funkcí , musíte ji volatStream.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é 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í to být relativní identifikátor URI, který se kombinuje sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaného prostředku. Pokud vlastnost QueryString není null
, připojí se 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 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é
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