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.

プロパティが空の文字列 ("" address ) ではなく、絶対 uri も含まれていaddressない場合、は、要求されたBaseAddressデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。 BaseAddressIf 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. プロパティが空の文字列でない場合は、にaddress追加されます。 QueryStringIf 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.

プロパティが空の文字列 ("" address ) ではなく、絶対 uri も含まれていaddressない場合、は、要求されたBaseAddressデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。 BaseAddressIf 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. プロパティが空の文字列でない場合は、にaddress追加されます。 QueryStringIf 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.

適用対象