HttpClient.GetAsync メソッド

  • リファレンス

定義

名前空間:
Windows.Web.Http

オーバーロード

GetAsync(Uri)

指定された URI に GET 要求を非同期操作として送信します。 HttpClient クラスのプログラミング ガイダンスとコード例については、HttpClient の概念に関するトピックを参照してください。
GetAsync(Uri, HttpCompletionOption)

HTTP 入力候補オプションを非同期操作として指定した URI に GET 要求を送信します。 HttpClient クラスのプログラミング ガイダンスとコード例については、HttpClient の概念に関するトピックを参照してください。

GetAsync(Uri)

編集

指定された URI に GET 要求を非同期操作として送信します。 HttpClient クラスのプログラミング ガイダンスとコード例については、HttpClient の概念に関するトピックを参照してください。

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri);
[Windows.Foundation.Metadata.Overload("GetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri);
function getAsync(uri)
Public Function GetAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

パラメーター

uri
Uri Uri

要求の送信先となる URI 。

戻り値

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

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

属性
OverloadAttribute RemoteAsyncAttribute

注釈

この操作はブロックされません。 返された IAsyncOperationWithProgress ( HttpResponseMessage と HttpProgress の) は、応答全体 (コンテンツを含む) が読み取られた後に完了します。

HttpClient と GetAsync(Uri) を使用して HTTP サーバーに接続し、GET 要求を送信する方法を示す C#/VB/C++ と XAML のサンプル コードについては、「HttpClient」を参照してください。

HttpClient と GetAsync(Uri) を使用して HTTP サーバーに接続し、GET 要求を送信する方法を示す JavaScript と HTML のサンプル コードについては、「Windows.Web.Http を使用して HTTP サーバーに接続する」を参照してください。

この関数がスローする例外を次に示します。

COMException

機能固有の HRESULT がメソッド呼び出しから返されるときにスローされます。

これは、ネットワーク メソッドによってスローされる最も一般的な例外です。 アプリでは、例外の HRESULT を使用してエラーの原因を特定する必要があります。

AccessDeniedException

リソースや機能へのアクセスが拒否されるとスローされます。 この例外は、要求されたネットワーク操作に必要なネットワーク機能がアプリ マニフェストに設定されていない場合に発生します。

InvalidArgumentException

メソッドに提供された引数のいずれかが有効でない場合にスローされます。

ユーザーが指定した入力によってこの例外が発生した場合、アプリはユーザーに通知し、新しい入力を要求できます。

ObjectDisposedException

破棄されたオブジェクトで操作が実行されるとスローされます。

OutOfMemoryException

操作を完了するために十分なメモリが使用できない場合にスローされます。

こちらもご覧ください

適用対象

GetAsync(Uri, HttpCompletionOption)

編集

HTTP 入力候補オプションを非同期操作として指定した URI に GET 要求を送信します。 HttpClient クラスのプログラミング ガイダンスとコード例については、HttpClient の概念に関するトピックを参照してください。

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri, HttpCompletionOption completionOption) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri, HttpCompletionOption const& completionOption);
[Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri, HttpCompletionOption completionOption);
function getAsync(uri, completionOption)
Public Function GetAsync (uri As Uri, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

パラメーター

uri
Uri Uri

要求の送信先の URI 。

completionOption
HttpCompletionOption

操作が完了したものと見なすタイミングを示す HTTP 完了オプション値。

戻り値

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

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

属性
OverloadAttribute RemoteAsyncAttribute

注釈

この操作はブロックされません。 返された IAsyncOperationWithProgress ( HttpResponseMessage および HttpProgress の) は、応答の一部または全部 (コンテンツを含む) が読み取られた後の completionOption パラメーターに基づいて完了します。

このコンテンツがスローする例外を次に示します。

COMException

機能固有の HRESULT がメソッド呼び出しから返されるときにスローされます。

これは、ネットワーク メソッドによってスローされる最も一般的な例外です。 アプリでは、例外の HRESULT を使用してエラーの原因を特定する必要があります。

AccessDeniedException

リソースや機能へのアクセスが拒否されるとスローされます。 この例外は、要求されたネットワーク操作に必要なネットワーク機能がアプリ マニフェストに設定されていない場合に発生します。

InvalidArgumentException

メソッドに提供された引数のいずれかが有効でない場合にスローされます。

ユーザーが指定した入力によってこの例外が発生した場合、アプリはユーザーに通知し、新しい入力を要求できます。

ObjectDisposedException

破棄されたオブジェクトで操作が実行されるとスローされます。

OutOfMemoryException

操作を完了するために十分なメモリが使用できない場合にスローされます。

こちらもご覧ください

適用対象