HttpClient.GetAsync 方法

定義

命名空間:

Windows.Web.Http

多載

GetAsync(Uri)	以非同步作業的方式，將 GET 要求傳送至指定的 URI。 如需 HttpClient 類別的程式設計指引和程式碼範例，請參閱 HttpClient 概念性主題。
GetAsync(Uri, HttpCompletionOption)	使用 HTTP 完成選項作為非同步作業，將 GET 要求傳送至指定的 URI 。 如需 HttpClient 類別的程式設計指引和程式碼範例，請參閱 HttpClient 概念性主題。

GetAsync(Uri)

以非同步作業的方式，將 GET 要求傳送至指定的 URI。 如需 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

備註

這項作業不會封鎖。 傳回的HttpResponseMessage和HttpProgress (IAsyncOperationWithProgress) 會在讀取整個回應 (包括內容) 之後完成。

如需 C#/VB/C++ 和 XAML 中的範例程式碼，示範如何使用 HttpClient 和 GetAsync (Uri) 連線到 HTTP 伺服器並傳送 GET 要求，請參閱 HttpClient。

如需 JavaScript 和 HTML 中的範例程式碼，示範如何使用 HttpClient 和 GetAsync (Uri) 連線到 HTTP 伺服器並傳送 GET 要求，請參閱 使用 Windows.Web.Http 連線到 HTTP 伺服器。

以下是此函式擲回的例外狀況。

COMException

從方法呼叫傳回功能特定的 HRESULT 時擲回。

這是網路方法擲回的最常見例外狀況。 應用程式應該使用例外狀況中的 HRESULT 來判斷錯誤的原因。

AccessDeniedException

在存取資源或功能遭拒時擲回。 當應用程式沒有針對所要求網路作業的應用程式資訊清單中設定所需的網路功能時，就會發生此例外狀況。

InvalidArgumentException

在其中一個提供給方法的引數無效時擲回。

如果使用者提供的輸入造成此例外狀況，應用程式可能會通知使用者並要求新的輸入。

ObjectDisposedException

在已處置的物件上執行作業時擲回。

OutOfMemoryException

當記憶體不足而無法完成作業時擲回。

另請參閱

• GetAsync(Uri, HttpCompletionOption)
• IAsyncOperationWithProgress<TResult,TProgress>
• Uri
• Windows.Web.Http
• 使用 Windows.Web.Http 連線到 HTTP 伺服器
• 處理網路應用程式中的例外狀況
• HttpResponseMessage
• HttpProgress
• System.Uri
• HttpClient

GetAsync(Uri, HttpCompletionOption)

使用 HTTP 完成選項作為非同步作業，將 GET 要求傳送至指定的 URI 。 如需 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

備註

這項作業不會封鎖。 傳回的HttpResponseMessage和HttpProgress (傳回的IAsyncOperationWithProgress) 會根據部分或所有回應 (完成，包括內容) 。

以下是此內容擲回的例外狀況。

COMException

從方法呼叫傳回功能特定的 HRESULT 時擲回。

這是網路方法擲回的最常見例外狀況。 應用程式應該使用例外狀況中的 HRESULT 來判斷錯誤的原因。

AccessDeniedException

在存取資源或功能遭拒時擲回。 當應用程式沒有針對所要求網路作業的應用程式資訊清單中設定所需的網路功能時，就會發生此例外狀況。

InvalidArgumentException

在其中一個提供給方法的引數無效時擲回。

如果使用者提供的輸入造成此例外狀況，應用程式可能會通知使用者並要求新的輸入。

ObjectDisposedException

在已處置的物件上執行作業時擲回。

OutOfMemoryException

當記憶體不足而無法完成作業時擲回。

另請參閱

• GetAsync(Uri)
• HttpCompletionOption
• IAsyncOperationWithProgress<TResult,TProgress>
• Uri
• Windows.Web.Http
• 使用 Windows.Web.Http 連線到 HTTP 伺服器
• 處理網路應用程式中的例外狀況
• HttpResponseMessage
• HttpProgress
• System.Uri
• HttpClient