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 (在部分或全部响应 (包括内容) 读取后根据 completionOption 参数完成。

下面是此内容引发的异常。

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