WebClient.DownloadString 方法

定义

命名空间:: System.Net

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

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

程序集:: System.dll

程序集:: netstandard.dll

重要

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

将请求的资源下载为 String。可将要下载的资源指定为包含 URI 或 Uri的 String。

重载

DownloadString(String)	将请求的资源下载为 String。要下载的资源被指定为包含 URI 的 String。
DownloadString(Uri)	将请求的资源下载为 String。要下载的资源被指定为 Uri。

DownloadString(String)

Source:: WebClient.cs

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

注解

谨慎

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

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

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

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

注意

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

适用于

DownloadString(Uri)

Source:: WebClient.cs

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 对象。