HttpClient.GetStringAsync メソッド

定義

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

オーバーロード

GetStringAsync(String)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

GetStringAsync(Uri)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

GetStringAsync(String, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

GetStringAsync(Uri, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

注釈

この操作はブロックされません。

GetStringAsync(String)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);
member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String) As Task(Of String)

パラメーター

requestUri
String

要求の送信先 URI。

戻り値

Task<String>

非同期操作を表すタスク オブジェクト。

例外

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

ネットワーク接続、DNS エラー、サーバー証明書の検証やタイムアウト (.NET Framework の場合のみ) などの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5.0 以降のみ: タイムアウトのため、要求は失敗しました。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答本体全体が読み取られた後に完了します。

注意

タイムアウトの場合:

適用対象

GetStringAsync(Uri)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);
member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri) As Task(Of String)

パラメーター

requestUri
Uri

要求の送信先 URI。

戻り値

Task<String>

非同期操作を表すタスク オブジェクト。

例外

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

ネットワーク接続、DNS エラー、サーバー証明書の検証やタイムアウト (.NET Framework の場合のみ) などの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5.0 以降のみ: タイムアウトのため、要求は失敗しました。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答本体全体が読み取られた後に完了します。

注意

タイムアウトの場合:

適用対象

GetStringAsync(String, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)

パラメーター

requestUri
String

要求の送信先 URI。

cancellationToken
CancellationToken

操作をキャンセルするキャンセル トークン。

戻り値

Task<String>

非同期操作を表すタスク オブジェクト。

例外

requestUrinull です。

ネットワーク接続、DNS エラー、サーバー証明書の検証やタイムアウト (.NET Framework の場合のみ) などの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5.0 以降のみ: タイムアウトのため、要求は失敗しました。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答本体全体が読み取られた後に完了します。

注意

タイムアウトの場合:

適用対象

GetStringAsync(Uri, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)

パラメーター

requestUri
Uri

要求の送信先 URI。

cancellationToken
CancellationToken

操作をキャンセルするキャンセル トークン。

戻り値

Task<String>

非同期操作を表すタスク オブジェクト。

例外

requestUrinull です。

ネットワーク接続、DNS エラー、サーバー証明書の検証やタイムアウト (.NET Framework の場合のみ) などの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5.0 以降のみ: タイムアウトのため、要求は失敗しました。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答本体全体が読み取られた後に完了します。

注意

タイムアウトの場合:

適用対象