다음을 통해 공유


HttpClient.GetAsync 메서드

정의

오버로드

GetAsync(Uri)

GET 요청을 지정된 URI에 비동기 작업으로 보냅니다. HttpClient 클래스 및 코드 예제에 대한 프로그래밍 지침은 HttpClient 개념 항목을 참조하세요.

GetAsync(Uri, HttpCompletionOption)

HTTP 완료 옵션을 비동기 작업으로 사용하여 지정된 Uri 에 GET 요청을 보냅니다. 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 ( HttpResponseMessageHttpProgress)는 전체 응답(콘텐츠 포함)을 읽은 후 완료됩니다.

HttpClient 및 GetAsync(Uri)를 사용하여 HTTP 서버에 연결하고 GET 요청을 보내는 방법을 보여 주는 C#/VB/C++ 및 XAML의 샘플 코드는 HttpClient를 참조하세요.

HttpClient 및 GetAsync(Uri)를 사용하여 HTTP 서버에 연결하고 GET 요청을 보내는 방법을 보여 주는 JavaScript 및 HTML의 샘플 코드는 Windows.Web.Http를 사용하여 HTTP 서버에 연결을 참조하세요.

다음은 이 함수가 throw하는 예외입니다.

COMException

메서드 호출에서 기능별 HRESULT 가 반환되면 throw됩니다.

네트워킹 메서드에서 throw되는 가장 일반적인 예외입니다. 앱은 예외의 HRESULT 를 사용하여 오류의 원인을 확인해야 합니다.

AccessDeniedException

리소스 또는 기능에 대한 액세스가 거부된 경우 throw됩니다. 이 예외는 앱에 요청된 네트워크 작업에 대한 앱 매니페스트에 설정된 필수 네트워크 기능이 없는 경우에 발생합니다.

InvalidArgumentException

메서드에 제공된 인수 중 하나가 유효하지 않을 때 throw됩니다.

사용자가 제공한 입력으로 인해 이 예외가 발생한 경우 앱이 사용자에게 알리고 새 입력을 요청할 수 있습니다.

ObjectDisposedException

삭제된 개체에서 연산이 수행될 때 throw됩니다.

OutOfMemoryException

메모리가 부족하여 작업을 완료할 수 있을 때 throw됩니다.

추가 정보

적용 대상

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 ( HttpResponseMessageHttpProgress)는 응답의 일부 또는 전부(콘텐츠 포함)를 읽은 후 completionOption 매개 변수에 따라 완료됩니다.

다음은 이 콘텐츠가 throw하는 예외입니다.

COMException

메서드 호출에서 기능별 HRESULT 가 반환되면 throw됩니다.

네트워킹 메서드에서 throw되는 가장 일반적인 예외입니다. 앱은 예외의 HRESULT 를 사용하여 오류의 원인을 확인해야 합니다.

AccessDeniedException

리소스 또는 기능에 대한 액세스가 거부된 경우 throw됩니다. 이 예외는 앱에 요청된 네트워크 작업에 대한 앱 매니페스트에 설정된 필수 네트워크 기능이 없는 경우에 발생합니다.

InvalidArgumentException

메서드에 제공된 인수 중 하나가 유효하지 않을 때 throw됩니다.

사용자가 제공한 입력으로 인해 이 예외가 발생한 경우 앱이 사용자에게 알리고 새 입력을 요청할 수 있습니다.

ObjectDisposedException

삭제된 개체에서 연산이 수행될 때 throw됩니다.

OutOfMemoryException

메모리가 부족하여 작업을 완료할 수 있을 때 throw됩니다.

추가 정보

적용 대상