WebClient.DownloadString 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
DownloadString(String) | |
DownloadString(Uri) |
DownloadString(String)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
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
參數
傳回
包含要求之資源的 String。
例外狀況
address
參數為 null
。
已經在多個執行緒上同時呼叫此方法。
範例
下列程式碼範例示範如何呼叫這個方法。
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
則必須是結合 BaseAddress 的相對 URI,才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源,會使用 GET 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
適用於
DownloadString(Uri)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
public:
System::String ^ DownloadString(Uri ^ address);
public string DownloadString (Uri address);
member this.DownloadString : Uri -> string
Public Function DownloadString (address As Uri) As String
參數
傳回
包含要求之資源的 String。
例外狀況
address
參數為 null
。
已經在多個執行緒上同時呼叫此方法。
備註
這個方法會擷取指定的資源。 下載資源之後,方法會使用 屬性中指定的 Encoding 編碼方式,將資源 String 轉換成 。 這個方法會在下載資源時封鎖。 若要下載資源,並在等候伺服器的回應時繼續執行,請使用其中 DownloadStringAsync 一種方法。
BaseAddress如果屬性不是空字串 (「」) 且 address
不包含絕對 URI, address
則必須是結合 BaseAddress 的相對 URI,才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源,會使用 GET 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應