WebClient.OpenRead Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Abre um fluxo legível para os dados baixados de um recurso com o URI especificado.

Sobrecargas

OpenRead(String)	Abre um fluxo legível para os dados baixados de um recurso com o URI especificado como um String.
OpenRead(Uri)	Abre um fluxo legível para os dados baixados de um recurso com o URI especificado como um Uri.

OpenRead(String)

Origem:

WebClient.cs

Abre um fluxo legível para os dados baixados 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

address

String

O URI especificado como um String do qual baixar dados.

Retornos

Stream

Um Stream usado para ler dados de um recurso.

Exceções

ArgumentNullException

O parâmetro address é null.

WebException

O URI formado pela combinação de BaseAddress, address é inválido.

-ou-

Erro ao baixar dados.

Exemplos

O exemplo de código a seguir abre o recurso identificado por uriString e exibe os resultados no console do sistema. O Stream retornado por OpenRead é fechado quando os dados são 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()

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método OpenRead cria uma instância de Stream usada para ler o conteúdo do recurso especificado pelo parâmetro address. Esse método bloqueia ao abrir o fluxo. Para continuar a execução enquanto aguarda o fluxo, use um dos métodos OpenReadAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for null, ela será acrescentada a address.

Esse método usa o comando RETR para baixar um recurso FTP. Para um recurso HTTP, o método GET é usado.

Nota

Você deve chamar Stream.Close quando terminar com o Stream para evitar ficar sem recursos do sistema.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

OpenRead(Uri)

Origem:

WebClient.cs

Abre um fluxo legível para os dados baixados 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

address

Uri

O URI especificado como um Uri do qual baixar dados.

Retornos

Stream

Um Stream usado para ler dados de um recurso.

Exceções

ArgumentNullException

O parâmetro address é null.

WebException

O URI formado pela combinação de BaseAddress, address é inválido.

-ou-

Erro ao baixar dados.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método OpenRead cria uma instância de Stream usada para ler o conteúdo do recurso especificado pelo parâmetro address. Esse método bloqueia ao abrir o fluxo. Para continuar a execução enquanto aguarda o fluxo, use um dos métodos OpenReadAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for null, ela será acrescentada a address.

Esse método usa o comando RETR para baixar um recurso FTP. Para um recurso HTTP, o método GET é usado.

Nota

Você deve chamar Stream.Close quando terminar com o Stream para evitar ficar sem recursos do sistema.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.