WebClient.OpenRead 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

为从具有指定 URI 的资源下载的数据打开可读流。

重载

OpenRead(String)	为从指定为 String的 URI 的资源下载的数据打开可读流。
OpenRead(Uri)	为从指定为 Uri的 URI 的资源下载的数据打开可读流。

OpenRead(String)

Source:

WebClient.cs

为从指定为 String的 URI 的资源下载的数据打开可读流。

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

指定要从中下载数据的 String 的 URI。

返回

Stream

用于从资源读取数据的 Stream。

例外

ArgumentNullException

address 参数 null。

WebException

通过组合 BaseAddress而形成的 URI 无效，address 无效。

-或-

下载数据时出错。

示例

下面的代码示例打开由 uriString 标识的资源，并在系统控制台上显示结果。 读取数据后，OpenRead 返回的 Stream 将关闭。

// 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 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。 如果未 nullQueryString 属性，则会将其追加到 address。

此方法使用 RETR 命令下载 FTP 资源。 对于 HTTP 资源，将使用 GET 方法。

注意

完成 Stream 后，必须调用 Stream.Close，以避免系统资源耗尽。

注意

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的 网络跟踪。

OpenRead(Uri)

Source:

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

通过组合 BaseAddress而形成的 URI 无效，address 无效。

-或-

下载数据时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

OpenRead 方法创建一个 Stream 实例，用于读取由 address 参数指定的资源的内容。 此方法在打开流时阻止。 若要在等待流时继续执行，请使用 OpenReadAsync 方法之一。

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。 如果未 nullQueryString 属性，则会将其追加到 address。

此方法使用 RETR 命令下载 FTP 资源。 对于 HTTP 资源，将使用 GET 方法。

注意

完成 Stream 后，必须调用 Stream.Close，以避免系统资源耗尽。

注意

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的 网络跟踪。