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 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
- Source:
- WebClient.cs
- 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
Devoluciones
Un objeto Stream que se utiliza para leer datos de un recurso.
Excepciones
El parámetro address
es null
.
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 null
es , 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 cuando Stream.Close termine con Stream para evitar que se agote el 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, vea Seguimiento de red en .NET Framework.
Se aplica a
OpenRead(Uri)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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
Devoluciones
Un objeto Stream que se utiliza para leer datos de un recurso.
Excepciones
El parámetro address
es null
.
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 null
es , 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 cuando Stream.Close termine con Stream para evitar que se agote el 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, vea Seguimiento de red en .NET Framework.
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de