次の方法で共有


HttpClient.GetAsync メソッド

定義

オーバーロード

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 ( HttpResponseMessageHttpProgress の) は、応答全体 (コンテンツを含む) が読み取られた後に完了します。

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 の) は、応答の一部または全部 (コンテンツを含む) が読み取られた後の completionOption パラメーターに基づいて完了します。

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

COMException

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

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

AccessDeniedException

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

InvalidArgumentException

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

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

ObjectDisposedException

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

OutOfMemoryException

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

こちらもご覧ください

適用対象