WebClient.OpenRead Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Abre una secuencia legible para los datos descargados de un recurso con el URI especificado.

Sobrecargas

OpenRead(String)	Abre una secuencia legible para los datos descargados de un recurso con el URI especificado como un String.
OpenRead(Uri)	Abre una secuencia legible para los datos descargados de un recurso con el URI especificado como un Uri.

OpenRead(String)

Source:

WebClient.cs

Abre una secuencia legible para los datos descargados de un recurso con el URI especificado como un 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

Parámetros

address

String

El URI especificado como un String desde el que descargar datos.

Devoluciones

Stream

Un Stream usado para leer datos de un recurso.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

El URI formado mediante la combinación de BaseAddress, address no es válido.

-o-

Error al descargar datos.

Ejemplos

En el ejemplo de código siguiente se abre el recurso identificado por uriString y se muestran los resultados en la consola del sistema. El Stream devuelto por OpenRead se cierra cuando se leen los datos.

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

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

El método OpenRead crea una instancia de Stream usada para leer el contenido del recurso especificado por el parámetro address. Este método se bloquea al abrir la secuencia. Para continuar ejecutándose mientras espera la secuencia, use uno de los métodos OpenReadAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es null, se anexa a address.

Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

Nota

Debe llamar a Stream.Close cuando termine con el Stream para evitar que se agote el sistema.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.

OpenRead(Uri)

Source:

WebClient.cs

Abre una secuencia legible para los datos descargados de un recurso con el URI especificado como un 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

Parámetros

address

Uri

El URI especificado como un Uri desde el que descargar datos.

Devoluciones

Stream

Un Stream usado para leer datos de un recurso.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

El URI formado mediante la combinación de BaseAddress, address no es válido.

-o-

Error al descargar datos.

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

El método OpenRead crea una instancia de Stream usada para leer el contenido del recurso especificado por el parámetro address. Este método se bloquea al abrir la secuencia. Para continuar ejecutándose mientras espera la secuencia, use uno de los métodos OpenReadAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es null, se anexa a address.

Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

Nota

Debe llamar a Stream.Close cuando termine con el Stream para evitar que se agote el sistema.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.