HttpClient.GetAsync 메서드

참조

정의

네임스페이스:: System.Net.Http

어셈블리:: System.Net.Http.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

GET 요청을 지정된 URI에 비동기 작업으로 보냅니다.

오버로드

GetAsync(String)	GET 요청을 지정된 URI에 비동기 작업으로 보냅니다.
GetAsync(Uri)	GET 요청을 지정된 URI에 비동기 작업으로 보냅니다.
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 완료 옵션 및 취소 토큰을 사용하여 지정한 URL에 비동기 작업으로 GET 요청을 보냅니다.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	HTTP 완료 옵션 및 취소 토큰을 사용하여 지정한 URL에 비동기 작업으로 GET 요청을 보냅니다.

설명

작업이 차단되지 않습니다.

GetAsync(String)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

GET 요청을 지정된 URI에 비동기 작업으로 보냅니다.

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);

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입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

UriFormatException

제공된 요청 URI가 유효한 상대 또는 절대 URI가 아닙니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다. 동작은 가 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

GetAsync(Uri)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

GET 요청을 지정된 URI에 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

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입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

설명

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

GetAsync(String, HttpCompletionOption)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

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);

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 완료 옵션 값입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

UriFormatException

제공된 요청 URI가 유효한 상대 또는 절대 URI가 아닙니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

GetAsync(String, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

취소 토큰이 포함된 지정한 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);

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

취소의 통지를 받기 위해 다른 개체나 스레드에서 사용할 수 있는 취소 토큰입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

UriFormatException

제공된 요청 URI가 유효한 상대 또는 절대 URI가 아닙니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

GetAsync(Uri, HttpCompletionOption)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

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);

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 완료 옵션 값입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

GetAsync(Uri, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

취소 토큰이 포함된 지정한 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);

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

취소의 통지를 받기 위해 다른 개체나 스레드에서 사용할 수 있는 취소 토큰입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

GetAsync(String, HttpCompletionOption, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

HTTP 완료 옵션 및 취소 토큰을 사용하여 지정한 URL에 비동기 작업으로 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);

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

취소의 통지를 받기 위해 다른 개체나 스레드에서 사용할 수 있는 취소 토큰입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

UriFormatException

제공된 요청 URI가 유효한 상대 또는 절대 URI가 아닙니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

HTTP 완료 옵션 및 취소 토큰을 사용하여 지정한 URL에 비동기 작업으로 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);

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

취소의 통지를 받기 위해 다른 개체나 스레드에서 사용할 수 있는 취소 토큰입니다.

반환

Task<HttpResponseMessage>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 파트 또는 모든 응답(콘텐츠 포함)을 읽은 후 매개 변수에 completionOption 따라 완료됩니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

HttpClient.GetAsync 메서드

정의

오버로드

설명

GetAsync(String)

매개 변수

반환

예외

설명

적용 대상

GetAsync(Uri)

매개 변수

반환

예외

설명

적용 대상

GetAsync(String, HttpCompletionOption)

매개 변수

반환

예외

설명

적용 대상

GetAsync(String, CancellationToken)

매개 변수

반환

예외

설명

적용 대상

GetAsync(Uri, HttpCompletionOption)

매개 변수

반환

예외

설명

적용 대상

GetAsync(Uri, CancellationToken)

매개 변수

반환

예외

설명

적용 대상

GetAsync(String, HttpCompletionOption, CancellationToken)

매개 변수

반환

예외

설명

적용 대상

GetAsync(Uri, HttpCompletionOption, CancellationToken)

매개 변수

반환

예외

설명

적용 대상

피드백

추가 리소스