WebClient.OpenRead Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- WebClient.cs
- 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.StreamPublic Function OpenRead (address As String) As StreamParámetros
Devoluciones
Un Stream usado para leer datos de un recurso.
Excepciones
El parámetro address es null.
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.
Se aplica a
OpenRead(Uri)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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.StreamPublic Function OpenRead (address As Uri) As StreamParámetros
Devoluciones
Un Stream usado para leer datos de un recurso.
Excepciones
El parámetro address es null.
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.
