WebClient.OpenRead Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает читаемый поток для данных, загруженных из ресурса с указанным URI.
Перегрузки
OpenRead(String) |
Открывает читаемый поток для данных, загруженных с ресурса, URI которого был указан как String. |
OpenRead(Uri) |
Открывает читаемый поток для данных, загруженных с ресурса, URI которого был указан как Uri. |
OpenRead(String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- 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
Параметры
Возвращаемое значение
Stream, используемый для чтения данных из ресурса.
Исключения
Параметр address
имеет значение null
.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- 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
Параметры
Возвращаемое значение
Stream, используемый для чтения данных из ресурса.
Исключения
Параметр address
имеет значение null
.
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.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по