WebClient.OpenRead WebClient.OpenRead WebClient.OpenRead WebClient.OpenRead Method

Definizione

Apre un flusso in lettura per i dati scaricati da una risorsa con l' URI specificato.Opens a readable stream for the data downloaded from a resource with the specified URI.

Overload

OpenRead(String) OpenRead(String) OpenRead(String) OpenRead(String)

Apre un flusso in lettura per i dati scaricati da una risorsa con l' URI specificato come classe String.Opens a readable stream for the data downloaded from a resource with the URI specified as a String.

OpenRead(Uri) OpenRead(Uri) OpenRead(Uri) OpenRead(Uri)

Apre un flusso in lettura per i dati scaricati da una risorsa con l' URI specificato come classe Uri.Opens a readable stream for the data downloaded from a resource with the URI specified as a Uri

OpenRead(String) OpenRead(String) OpenRead(String) OpenRead(String)

Apre un flusso in lettura per i dati scaricati da una risorsa con l' URI specificato come classe String.Opens a readable stream for the data downloaded from a resource with the URI specified as a String.

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

Parametri

address
String String String String

L'URI specificato come classe String da cui eseguire il download dei dati.The URI specified as a String from which to download data.

Restituisce

Un Stream utilizzato per leggere dati da una risorsa.A Stream used to read data from a resource.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

L'URI composto dalla combinazione di BaseAddress e address non è valido.The URI formed by combining BaseAddress, address is invalid.

In alternativa-or- Si è verificato un errore durante il download dei dati.An error occurred while downloading data.

Esempi

Esempio di codice seguente consente di aprire la risorsa identificata dal uriString e visualizza i risultati nella console di sistema.The following code example opens the resource identified by uriString and displays the results on the system console. Si noti che il Stream restituito da OpenRead viene chiuso quando i dati sono stati letti.Note that the Stream returned by OpenRead is closed when the data has been read.

// 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()

Commenti

Il OpenRead metodo crea un Stream usato per leggere il contenuto della risorsa specificata dall'istanza di address parametro.The OpenRead method creates a Stream instance used to read the contents of the resource specified by the address parameter. Questo metodo si blocca durante l'apertura del flusso.This method blocks while opening the stream. Per continuare l'esecuzione durante l'attesa per il flusso, utilizzare uno del OpenReadAsync metodi.To continue executing while waiting for the stream, use one of the OpenReadAsync methods.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è null, questo viene aggiunto a address.If the QueryString property is not null, it is appended to address.

Questo metodo Usa il comando RETR per scaricare una risorsa di FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo GET.For an HTTP resource, the GET method is used.

Nota

È necessario chiamare Stream.Close dopo aver utilizzato la Stream per evitare di esaurire le risorse di sistema.You must call Stream.Close when finished with the Stream to avoid running out of system resources.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenRead(Uri) OpenRead(Uri) OpenRead(Uri) OpenRead(Uri)

Apre un flusso in lettura per i dati scaricati da una risorsa con l' URI specificato come classe Uri.Opens a readable stream for the data downloaded from a resource with the URI specified as a Uri

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

Parametri

address
Uri Uri Uri Uri

L'URI specificato come classe Uri da cui eseguire il download dei dati.The URI specified as a Uri from which to download data.

Restituisce

Un Stream utilizzato per leggere dati da una risorsa.A Stream used to read data from a resource.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

L'URI composto dalla combinazione di BaseAddress e address non è valido.The URI formed by combining BaseAddress, address is invalid.

In alternativa-or- Si è verificato un errore durante il download dei dati.An error occurred while downloading data.

Commenti

Il OpenRead metodo crea un Stream usato per leggere il contenuto della risorsa specificata dall'istanza di address parametro.The OpenRead method creates a Stream instance used to read the contents of the resource specified by the address parameter. Questo metodo si blocca durante l'apertura del flusso.This method blocks while opening the stream. Per continuare l'esecuzione durante l'attesa per il flusso, utilizzare uno del OpenReadAsync metodi.To continue executing while waiting for the stream, use one of the OpenReadAsync methods.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è null, questo viene aggiunto a address.If the QueryString property is not null, it is appended to address.

Questo metodo Usa il comando RETR per scaricare una risorsa di FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo GET.For an HTTP resource, the GET method is used.

Nota

È necessario chiamare Stream.Close dopo aver utilizzato la Stream per evitare di esaurire le risorse di sistema.You must call Stream.Close when finished with the Stream to avoid running out of system resources.

Nota questo membro genera informazioni di traccia quando si abilita la traccia di rete nell'applicazione.Note This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Si applica a