WebClient.OpenRead 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 pro data stažená z prostředku se zadaným identifikátorem URI.
Přetížení
OpenRead(String) |
Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným Stringjako . |
OpenRead(Uri) |
Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným Urijako . |
OpenRead(String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným Stringjako .
public:
System::IO::Stream ^ OpenRead(System::String ^ address);
public System.IO.Stream OpenRead (string address);
member this.OpenRead : string -> System.IO.Stream
Public Function OpenRead (address As String) As Stream
Parametry
- address
- String
Identifikátor URI zadaný jako String identifikátor, ze kterého se mají stahovat data.
Návraty
Slouží Stream ke čtení dat z prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
je neplatný.
-nebo-
Při stahování dat došlo k chybě.
Příklady
Následující příklad kódu otevře prostředek identifikovaný uživatelem uriString
a zobrazí výsledky v systémové konzole.
Stream Vrácené uživatelem OpenRead se po přečtení dat zavře.
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Download home page data.
Console::WriteLine( "Accessing {0} ...", uriString );
// Open a stream to point to the data stream coming from the Web resource.
Stream^ myStream = myWebClient->OpenRead( uriString );
Console::WriteLine( "\nDisplaying Data :\n" );
StreamReader^ sr = gcnew StreamReader( myStream );
Console::WriteLine( sr->ReadToEnd() );
// Close the stream.
myStream->Close();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Download home page data.
Console.WriteLine("Accessing {0} ...", uriString);
// Open a stream to point to the data stream coming from the Web resource.
Stream myStream = myWebClient.OpenRead(uriString);
Console.WriteLine("\nDisplaying Data :\n");
StreamReader sr = new StreamReader(myStream);
Console.WriteLine(sr.ReadToEnd());
// Close the stream.
myStream.Close();
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Download home page data.
Console.WriteLine("Accessing {0} ...", uriString)
' Open a stream to point to the data stream coming from the Web resource.
Dim myStream As Stream = myWebClient.OpenRead(uriString)
Console.WriteLine(ControlChars.Cr + "Displaying Data :" + ControlChars.Cr)
Dim sr As New StreamReader(myStream)
Console.WriteLine(sr.ReadToEnd())
' Close the stream.
myStream.Close()
Poznámky
Metoda OpenRead vytvoří Stream instanci použitou ke čtení obsahu prostředku určeného parametrem address
. Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z OpenReadAsync metod.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. 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
Pokud chcete zabránit tomu, že dojde systémové prostředky, musíte po dokončení Stream volání volatStream.Close.
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.
Platí pro
OpenRead(Uri)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným Urijako .
public:
System::IO::Stream ^ OpenRead(Uri ^ address);
public System.IO.Stream OpenRead (Uri address);
member this.OpenRead : Uri -> System.IO.Stream
Public Function OpenRead (address As Uri) As Stream
Parametry
Návraty
Slouží Stream ke čtení dat z prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
je neplatný.
-nebo-
Při stahování dat došlo k chybě.
Poznámky
Metoda OpenRead vytvoří Stream instanci použitou ke čtení obsahu prostředku určeného parametrem address
. Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z OpenReadAsync metod.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. 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
Pokud chcete zabránit tomu, že dojde systémové prostředky, musíte po dokončení Stream volání volatStream.Close.
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.
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