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 de los datos descargados desde un recurso con el URI especificado como String.
OpenRead(Uri)	Abre una secuencia legible de los datos descargados desde un recurso con el URI especificado como Uri.

OpenRead(String)

Source:

WebClient.cs

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

Identificador URI especificado como String desde el que se descargan los datos.

Devoluciones

Stream

Un objeto Stream que se utiliza para leer datos de un recurso.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

Se ha producido un error al descargar los 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

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

Si la BaseAddress propiedad 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 QueryString propiedad no nulles , 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 Stream.Close a cuando haya terminado con Stream para evitar que se agote el número de recursos del sistema.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

OpenRead(Uri)

Source:

WebClient.cs

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

Identificador URI especificado como Uri desde el que se descargan los datos.

Devoluciones

Stream

Un objeto Stream que se utiliza para leer datos de un recurso.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

Se ha producido un error al descargar los datos.

Comentarios

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

Si la BaseAddress propiedad 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 QueryString propiedad no nulles , 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 Stream.Close a cuando haya terminado con Stream para evitar que se agote el número de recursos del sistema.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.