HttpClient.GetStringAsync メソッド

定義

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

オーバーロード

GetStringAsync(String)

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

GetStringAsync(Uri)

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

GetStringAsync(String, CancellationToken)

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

GetStringAsync(Uri, CancellationToken)

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

注釈

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

GetStringAsync(String)

ソース:
HttpClient.cs
ソース:
HttpClient.cs
ソース:
HttpClient.cs

指定 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。

戻り値

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

例外

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

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

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

注釈

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

注意

タイムアウトの場合:

適用対象

GetStringAsync(Uri)

ソース:
HttpClient.cs
ソース:
HttpClient.cs
ソース:
HttpClient.cs

指定 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。

戻り値

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

例外

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

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

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

注釈

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

注意

タイムアウトの場合:

適用対象

GetStringAsync(String, CancellationToken)

ソース:
HttpClient.cs
ソース:
HttpClient.cs
ソース:
HttpClient.cs

指定 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

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

戻り値

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

例外

requestUrinull です。

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

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

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

注意

タイムアウトの場合:

適用対象

GetStringAsync(Uri, CancellationToken)

ソース:
HttpClient.cs
ソース:
HttpClient.cs
ソース:
HttpClient.cs

指定 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

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

戻り値

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

例外

requestUrinull です。

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

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

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

注意

タイムアウトの場合:

適用対象