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

Параметр address имеет значение null.

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

Комментарии

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, то это должен быть относительный URI, address который объединяется с 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

Параметр address имеет значение null.

WebException

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

-или-

При загрузке данных произошла ошибка.

Комментарии

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

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

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

Примечание

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.