WebClient.DownloadString WebClient.DownloadString WebClient.DownloadString WebClient.DownloadString Method

定義

要求されたリソースを String としてダウンロードします。Downloads the requested resource as a String. ダウンロードするリソースは、URI を含む String として、または Uri として指定できます。The resource to download may be specified as either String containing the URI or a Uri.

オーバーロード

DownloadString(String) DownloadString(String) DownloadString(String) DownloadString(String)

要求されたリソースを String としてダウンロードします。Downloads the requested resource as a String. ダウンロードするリソースは、URI を含む String として指定します。The resource to download is specified as a String containing the URI.

DownloadString(Uri) DownloadString(Uri) DownloadString(Uri) DownloadString(Uri)

要求されたリソースを String としてダウンロードします。Downloads the requested resource as a String. ダウンロードするリソースは、Uri として指定します。The resource to download is specified as a Uri.

DownloadString(String) DownloadString(String) DownloadString(String) DownloadString(String)

要求されたリソースを String としてダウンロードします。Downloads the requested resource as a String. ダウンロードするリソースは、URI を含む String として指定します。The resource to download is specified as a String containing the URI.

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 String String String

ダウンロードする URI を格納している StringA String containing the URI to download.

戻り値

要求されたリソースを格納する StringA String containing the requested resource.

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

または-or- リソースのダウンロード中にエラーが発生しました。An error occurred while downloading the resource.

このメソッドは、複数のスレッドで同時に呼び出されています。The method has been called simultaneously on multiple threads.

次のコード例では、このメソッドの呼び出しを示しています。The following code example demonstrates calling this method.

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


注釈

このメソッドは、指定したリソースを取得します。This method retrieves the specified resource. メソッドに指定されたエンコーディングを使用して、リソースをダウンロードした後、Encodingをリソースに変換するプロパティ、Stringします。After it downloads the resource, the method uses the encoding specified in the Encoding property to convert the resource to a String. リソースのダウンロード中に、このメソッドはブロックします。This method blocks while downloading the resource. リソースをダウンロードして、サーバーの応答の待機中に実行を継続のいずれかの操作を使用して、DownloadStringAsyncメソッド。To download a resource and continue executing while waiting for the server's response, use one of the DownloadStringAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 場合、QueryStringプロパティは空の文字列ではありませんに追加されますaddressします。If the QueryString property is not an empty string, it is appended to address.

このメソッドでは、RETR コマンドを使用して、FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースでは、GET メソッドを使用します。For an HTTP resource, the GET method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、次を参照してください。ネットワークのトレースを .NET Framework でします。For more information, see Network Tracing in the .NET Framework.

DownloadString(Uri) DownloadString(Uri) DownloadString(Uri) DownloadString(Uri)

要求されたリソースを String としてダウンロードします。Downloads the requested resource as a String. ダウンロードするリソースは、Uri として指定します。The resource to download is specified as a 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 Uri

ダウンロードする URI を格納している Uri オブジェクト。A Uri object containing the URI to download.

戻り値

要求されたリソースを格納する StringA String containing the requested resource.

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

または-or- リソースのダウンロード中にエラーが発生しました。An error occurred while downloading the resource.

このメソッドは、複数のスレッドで同時に呼び出されています。The method has been called simultaneously on multiple threads.

注釈

このメソッドは、指定したリソースを取得します。This method retrieves the specified resource. メソッドに指定されたエンコーディングを使用して、リソースをダウンロードした後、Encodingをリソースに変換するプロパティ、Stringします。After it downloads the resource, the method uses the encoding specified in the Encoding property to convert the resource to a String. リソースのダウンロード中に、このメソッドはブロックします。This method blocks while downloading the resource. リソースをダウンロードして、サーバーの応答の待機中に実行を継続のいずれかの操作を使用して、DownloadStringAsyncメソッド。To download a resource and continue executing while waiting for the server's response, use one of the DownloadStringAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 場合、QueryStringプロパティは空の文字列ではありませんに追加されますaddressします。If the QueryString property is not an empty string, it is appended to address.

このメソッドでは、RETR コマンドを使用して、FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースでは、GET メソッドを使用します。For an HTTP resource, the GET method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、次を参照してください。ネットワークのトレースを .NET Framework でします。For more information, see Network Tracing in the .NET Framework.

適用対象