HttpClient.GetStringAsync 메서드

정의

네임스페이스:

System.Net.Http

어셈블리:

System.Net.Http.dll

GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.

오버로드

GetStringAsync(String)	GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.
GetStringAsync(Uri)	GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.
GetStringAsync(String, CancellationToken)	GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.
GetStringAsync(Uri, CancellationToken)	GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.

설명

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

GetStringAsync(String)

Source:

HttpClient.cs

GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.

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

반환

Task<String>

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

예외

InvalidOperationException

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

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사(또는 .NET Framework의 경우에만 시간 초과)와 같은 기본 문제로 인해 요청이 실패했습니다.

TaskCanceledException

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

UriFormatException

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

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답 본문을 읽은 후에 완료됩니다.

참고

시간 제한의 경우:

• .NET Framework 을 HttpRequestExceptionthrow합니다.
• .NET Core는 내부 예외 없이 을 TaskCanceledException throw합니다.
• .NET 5 이상 버전은 를 TaskCanceledException 중첩하는 을 TimeoutExceptionthrow합니다.

GetStringAsync(Uri)

Source:

HttpClient.cs

GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.

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

반환

Task<String>

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

예외

InvalidOperationException

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

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사(또는 .NET Framework의 경우에만 시간 초과)와 같은 기본 문제로 인해 요청이 실패했습니다.

TaskCanceledException

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

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답 본문을 읽은 후에 완료됩니다.

참고

시간 제한의 경우:

• .NET Framework 을 HttpRequestExceptionthrow합니다.
• .NET Core는 내부 예외 없이 을 TaskCanceledException throw합니다.
• .NET 5 이상 버전은 를 TaskCanceledException 중첩하는 을 TimeoutExceptionthrow합니다.

GetStringAsync(String, CancellationToken)

Source:

HttpClient.cs

GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)

매개 변수

requestUri

String

요청이 전송되는 URI입니다.

cancellationToken

CancellationToken

작업을 취소할 취소 토큰입니다.

반환

Task<String>

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

예외

ArgumentNullException

requestUri이 null인 경우

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사(또는 .NET Framework의 경우에만 시간 초과)와 같은 기본 문제로 인해 요청이 실패했습니다.

TaskCanceledException

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

UriFormatException

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

OperationCanceledException

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

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답 본문을 읽은 후에 완료됩니다.

참고

시간 제한의 경우:

• .NET Framework 을 HttpRequestExceptionthrow합니다.
• .NET Core는 내부 예외 없이 을 TaskCanceledException throw합니다.
• .NET 5 이상 버전은 를 TaskCanceledException 중첩하는 을 TimeoutExceptionthrow합니다.

GetStringAsync(Uri, CancellationToken)

Source:

HttpClient.cs

GET 요청을 지정된 URI에 보내고 비동기 작업에서 문자열로 응답 본문을 반환합니다.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)

매개 변수

requestUri

Uri

요청이 전송되는 URI입니다.

cancellationToken

CancellationToken

작업을 취소할 취소 토큰입니다.

반환

Task<String>

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

예외

ArgumentNullException

requestUri이 null인 경우

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사(또는 .NET Framework의 경우에만 시간 초과)와 같은 기본 문제로 인해 요청이 실패했습니다.

TaskCanceledException

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

OperationCanceledException

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

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답 본문을 읽은 후에 완료됩니다.

참고

시간 제한의 경우:

• .NET Framework 을 HttpRequestExceptionthrow합니다.
• .NET Core는 내부 예외 없이 을 TaskCanceledException throw합니다.
• .NET 5 이상 버전은 를 TaskCanceledException 중첩하는 을 TimeoutExceptionthrow합니다.