WebClient.DownloadString メソッド

  • リファレンス

定義

名前空間:
System.Net
アセンブリ:
System.Net.WebClient.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

要求されたリソースを String としてダウンロードします。 ダウンロードするリソースは、URI を含む String として、または Uri として指定できます。

オーバーロード

DownloadString(String)

要求されたリソースを String としてダウンロードします。 ダウンロードするリソースは、URI を含む String として指定します。
DownloadString(Uri)

要求されたリソースを String としてダウンロードします。 ダウンロードするリソースは、Uri として指定します。

DownloadString(String)

要求されたリソースを 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 と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address追加されます。

このメソッドは、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合は、GET メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

適用対象

DownloadString(Uri)

要求されたリソースを 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 オブジェクト。

戻り値

String

要求されたリソースを格納する String。

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

リソースのダウンロード中にエラーが発生しました。

NotSupportedException

このメソッドは、複数のスレッドで同時に呼び出されています。

注釈

このメソッドは、指定されたリソースを取得します。 リソースをダウンロードした後、 メソッドは、 プロパティで指定されたエンコーディングを Encoding 使用してリソースを に String変換します。 このメソッドは、リソースのダウンロード中にブロックします。 リソースをダウンロードし、サーバーの応答を待機しながら実行を続けるには、いずれかのメソッドを DownloadStringAsync 使用します。

プロパティが BaseAddress 空の文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address追加されます。

このメソッドは、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合は、GET メソッドが使用されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

適用対象