HttpClient.GetStringAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 URI에 GET 요청을 보내고 비동기 작업에서 응답 본문을 문자열로 반환합니다.
오버로드
| Name | Description |
|---|---|
| GetStringAsync(String) |
지정된 URI에 GET 요청을 보내고 비동기 작업에서 응답 본문을 문자열로 반환합니다. |
| GetStringAsync(Uri) |
지정된 URI에 GET 요청을 보내고 비동기 작업에서 응답 본문을 문자열로 반환합니다. |
설명
이 작업은 차단되지 않습니다.
GetStringAsync(String)
지정된 URI에 GET 요청을 보내고 비동기 작업에서 응답 본문을 문자열로 반환합니다.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync(string requestUri);member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As String) As Task(Of String)매개 변수
- requestUri
- String
요청이 전송되는 URI입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
응답 상태 코드가 200-299(표준에 따라 성공을 나타낸) 범위를 벗어났습니다.
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답 본문을 읽은 후에 완료됩니다.
내부적으로 이 작업은 HttpResponseMessage.EnsureSuccessStatusCode 응답 상태 코드가 성공 범위(200-299)에 있는지 확인하고 그렇지 않은 경우 throw합니다 HttpRequestException .
일부 시나리오에서는 성공한 것으로 간주되는 상태 코드를 더 자세히 제어해야 할 수 있습니다. 예를 들어 API는 항상 반환 200 OK될 수 있습니다. 이러한 경우 예상 값과 일치하는지 StatusCode 수동으로 확인하는 것이 좋습니다.
메모
시간 제한의 경우:
- .NET Framework는 HttpRequestException throw합니다.
- .NET Core는 내부 예외 없이 OperationCanceledException throw합니다.
- .NET 5 이상 버전은 TimeoutException 중첩하는 OperationCanceledException throw합니다.
적용 대상
GetStringAsync(Uri)
지정된 URI에 GET 요청을 보내고 비동기 작업에서 응답 본문을 문자열로 반환합니다.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync(Uri requestUri);member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As Uri) As Task(Of String)매개 변수
- requestUri
- Uri
요청이 전송되는 URI입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
응답 상태 코드가 200-299(표준에 따라 성공을 나타낸) 범위를 벗어났습니다.
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답 본문을 읽은 후에 완료됩니다.
내부적으로 이 작업은 HttpResponseMessage.EnsureSuccessStatusCode 응답 상태 코드가 성공 범위(200-299)에 있는지 확인하고 그렇지 않은 경우 throw합니다 HttpRequestException .
일부 시나리오에서는 성공한 것으로 간주되는 상태 코드를 더 자세히 제어해야 할 수 있습니다. 예를 들어 API는 항상 반환 200 OK될 수 있습니다. 이러한 경우 예상 값과 일치하는지 StatusCode 수동으로 확인하는 것이 좋습니다.
메모
시간 제한의 경우:
- .NET Framework는 HttpRequestException throw합니다.
- .NET Core는 내부 예외 없이 OperationCanceledException throw합니다.
- .NET 5 이상 버전은 TimeoutException 중첩하는 OperationCanceledException throw합니다.