HttpClient.GetAsync メソッド

リファレンス

定義

名前空間:: Windows.Web.Http

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

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 完了オプション値。

戻り値