WebClient.OpenRead Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Abre um fluxo legível para os dados descarregados de um recurso com o URI especificado.
Sobrecargas
| Name | Description |
|---|---|
| OpenRead(String) |
Abre um fluxo legível para os dados descarregados de um recurso com o URI especificado como um String. |
| OpenRead(Uri) |
Abre um fluxo legível para os dados descarregados de um recurso com o URI especificado como um Uri. |
OpenRead(String)
Abre um fluxo legível para os dados descarregados de um recurso com o URI especificado como um 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
Devoluções
A Stream usado para ler dados de um recurso.
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddressde , address é inválido.
-ou-
Ocorreu um erro durante o download dos dados.
Exemplos
O exemplo de código seguinte abre o recurso identificado por uriString e apresenta os resultados na consola do sistema. O Stream devolvido por OpenRead está fechado quando os dados foram lidos.
// 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()
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
O OpenRead método cria uma Stream instância usada para ler o conteúdo do recurso especificado pelo address parâmetro. Este método bloqueia ao abrir o fluxo. Para continuar a executar enquanto espera pela transmissão, use um dos OpenReadAsync métodos.
Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não nullfor , é anexada a address.
Este método utiliza o comando RETR para descarregar um recurso FTP. Para um recurso HTTP, utiliza-se o método GET.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.
Aplica-se a
OpenRead(Uri)
Abre um fluxo legível para os dados descarregados de um recurso com o URI especificado como um 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
Devoluções
A Stream usado para ler dados de um recurso.
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddressde , address é inválido.
-ou-
Ocorreu um erro durante o download dos dados.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
O OpenRead método cria uma Stream instância usada para ler o conteúdo do recurso especificado pelo address parâmetro. Este método bloqueia ao abrir o fluxo. Para continuar a executar enquanto espera pela transmissão, use um dos OpenReadAsync métodos.
Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não nullfor , é anexada a address.
Este método utiliza o comando RETR para descarregar um recurso FTP. Para um recurso HTTP, utiliza-se o método GET.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.