WebClient.DownloadString 方法

参考

定义

命名空间:: System.Net

程序集:: System.Net.WebClient.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

以 String 形式下载请求的资源。可以以包含 URI 的 String 或 Uri 的形式指定要下载的资源。

重载

DownloadString(String)	以 String 形式下载请求的资源。以包含 URI 的 String 的形式指定要下载的资源。
DownloadString(Uri)	以 String 形式下载请求的资源。以 Uri 形式指定要下载的资源。

DownloadString(String)

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

以 String 形式下载请求的资源。以包含 URI 的 String 的形式指定要下载的资源。

public:
 System::String ^ DownloadString(System::String ^ address);

public string DownloadString (string address);

member this.DownloadString : string -> string

Public Function DownloadString (address As String) As String

参数

address: String

包含要下载的 URI 的 String。

String

一个 String，其中包含请求的资源。

例外

ArgumentNullException

address 参数为 null。

WebException

通过组合 BaseAddress 和 address 所构成的 URI 无效。

- 或 -

下载资源时出现错误。

NotSupportedException

该方法已在多个线程上同时调用。

示例

下面的代码示例演示如何调用此方法。

void DownloadString( String^ address )
{
   WebClient^ client = gcnew WebClient;
   String^ reply = client->DownloadString( address );
   Console::WriteLine( reply );
}

public static void DownloadString(string address)
{
    WebClient client = new WebClient();
    string reply = client.DownloadString(address);

    Console.WriteLine(reply);
}

Public Shared Sub DownloadString(ByVal address As String)

    Dim client As WebClient = New WebClient()
    Dim reply As String = client.DownloadString(address)

    Console.WriteLine(reply)
End Sub

注解

此方法检索指定的资源。下载资源后，方法使用属性中指定的 Encoding 编码将资源转换为 String。此方法在下载资源时阻止。若要下载资源并在等待服务器的响应时继续执行，请使用方法之 DownloadStringAsync 一。

BaseAddress如果属性不是空字符串 (“”) ，并且address不包含绝对 URI，address则必须是一个相对 URI，与 BaseAddress 组合在一起以构成所请求数据的绝对 URI。 QueryString如果属性不是空字符串，则会将其追加到 address。

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

备注

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

适用于

DownloadString(Uri)

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

以 String 形式下载请求的资源。以 Uri 形式指定要下载的资源。

public:
 System::String ^ DownloadString(Uri ^ address);

public string DownloadString (Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String

参数

address: Uri

一个 Uri 对象，其中包含要下载的 URI。