WebClient.OpenRead Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebClient.dll

Открывает доступный для чтения поток для данных, скачанных из ресурса с указанным универсальным кодом ресурса (URI).

Перегрузки

OpenRead(String)	Открывает доступный для чтения поток для данных, скачанных из ресурса с универсальным кодом ресурса (URI), указанным в качестве String.
OpenRead(Uri)	Открывает доступный для чтения поток для данных, скачанных из ресурса с универсальным кодом ресурса (URI), указанным в качестве Uri.

OpenRead(String)

Исходный код:

WebClient.cs

Открывает доступный для чтения поток для данных, скачанных из ресурса с универсальным кодом ресурса (URI), указанным в качестве 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

Параметры

address

String

Универсальный код ресурса (URI), указанный в качестве String, из которого необходимо скачать данные.

Возвращаемое значение

Stream

Stream используется для чтения данных из ресурса.

Исключения

ArgumentNullException

Параметр addressnull.

WebException

URI, сформированный путем объединения BaseAddress, address недопустим.

-или-

Произошла ошибка при скачивании данных.

Примеры

В следующем примере кода открывается ресурс, определенный uriString, и отображаются результаты в системной консоли. Stream, возвращенные OpenRead, закрываются при чтении данных.

// 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()

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод OpenRead создает экземпляр Stream, используемый для чтения содержимого ресурса, указанного параметром address. Этот метод блокирует при открытии потока. Чтобы продолжить выполнение во время ожидания потока, используйте один из методов OpenReadAsync.

Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не null, оно добавляется к address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Заметка

Необходимо вызвать Stream.Close после завершения работы с Stream, чтобы избежать использования системных ресурсов.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.

OpenRead(Uri)

Исходный код:

WebClient.cs

Открывает доступный для чтения поток для данных, скачанных из ресурса с универсальным кодом ресурса (URI), указанным в качестве 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

Параметры

address

Uri

Универсальный код ресурса (URI), указанный в качестве Uri, из которого необходимо скачать данные.

Возвращаемое значение

Stream

Stream используется для чтения данных из ресурса.

Исключения

ArgumentNullException

Параметр addressnull.

WebException

URI, сформированный путем объединения BaseAddress, address недопустим.

-или-

Произошла ошибка при скачивании данных.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод OpenRead создает экземпляр Stream, используемый для чтения содержимого ресурса, указанного параметром address. Этот метод блокирует при открытии потока. Чтобы продолжить выполнение во время ожидания потока, используйте один из методов OpenReadAsync.

Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не null, оно добавляется к address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Заметка

Необходимо вызвать Stream.Close после завершения работы с Stream, чтобы избежать использования системных ресурсов.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.