WebClient.OpenRead Метод

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.WebClient.dll
Сборка:
System.dll
Сборка:
netstandard.dll

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

Перегрузки

OpenRead(String)

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

Открывает читаемый поток для данных, загруженных с ресурса, URI которого был указан как Uri.

OpenRead(String)

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

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

Применяется к