HttpClient.GetAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 URI에 GET 요청을 비동기 작업으로 보냅니다.
오버로드
| Name | Description |
|---|---|
| GetAsync(String) |
지정된 URI에 GET 요청을 비동기 작업으로 보냅니다. |
| GetAsync(Uri) |
지정된 URI에 GET 요청을 비동기 작업으로 보냅니다. |
| GetAsync(String, HttpCompletionOption) |
HTTP 완료 옵션을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다. |
| GetAsync(String, CancellationToken) |
취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다. |
| GetAsync(Uri, HttpCompletionOption) |
HTTP 완료 옵션을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다. |
| GetAsync(Uri, CancellationToken) |
취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다. |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
HTTP 완료 옵션 및 취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다. |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
HTTP 완료 옵션 및 취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다. |
설명
작업이 차단되지 않습니다.
GetAsync(String)
지정된 URI에 GET 요청을 비동기 작업으로 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri);member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- String
요청이 전송되는 URI입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다. 동작은 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
GetAsync(Uri)
지정된 URI에 GET 요청을 비동기 작업으로 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri);member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- Uri
요청이 전송되는 URI입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다. 동작은 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
GetAsync(String, HttpCompletionOption)
HTTP 완료 옵션을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- String
요청이 전송되는 URI입니다.
- completionOption
- HttpCompletionOption
작업이 완료된 것으로 간주되어야 하는 시기를 나타내는 HTTP 완료 옵션 값입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 제한과 같은 기본 문제로 인해 요청이 실패했습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
GetAsync(String, CancellationToken)
취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- String
요청이 전송되는 URI입니다.
- cancellationToken
- CancellationToken
다른 개체 또는 스레드에서 취소 알림을 받는 데 사용할 수 있는 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다. 동작은 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
GetAsync(Uri, HttpCompletionOption)
HTTP 완료 옵션을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- Uri
요청이 전송되는 URI입니다.
- completionOption
- HttpCompletionOption
작업이 완료된 것으로 간주되어야 하는 시기를 나타내는 HTTP 완료 옵션 값입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
GetAsync(Uri, CancellationToken)
취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- Uri
요청이 전송되는 URI입니다.
- cancellationToken
- CancellationToken
다른 개체 또는 스레드에서 취소 알림을 받는 데 사용할 수 있는 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결, DNS 오류 또는 서버 인증서 유효성 검사와 같은 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다. 동작은 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
GetAsync(String, HttpCompletionOption, CancellationToken)
HTTP 완료 옵션 및 취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- String
요청이 전송되는 URI입니다.
- completionOption
- HttpCompletionOption
작업이 완료된 것으로 간주되어야 하는 시기를 나타내는 HTTP 완료 옵션 값입니다.
- cancellationToken
- CancellationToken
다른 개체 또는 스레드에서 취소 알림을 받는 데 사용할 수 있는 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
GetAsync(Uri, HttpCompletionOption, CancellationToken)
HTTP 완료 옵션 및 취소 토큰을 비동기 작업으로 사용하여 지정된 URI에 GET 요청을 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- Uri
요청이 전송되는 URI입니다.
- completionOption
- HttpCompletionOption
작업이 완료된 것으로 간주되어야 하는 시기를 나타내는 HTTP 완료 옵션 값입니다.
- cancellationToken
- CancellationToken
다른 개체 또는 스레드에서 취소 알림을 받는 데 사용할 수 있는 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.