HttpClient.GetStringAsync 메서드

정의

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

오버로드

GetStringAsync(String)

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

GetStringAsync(Uri)

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

GetStringAsync(String, CancellationToken)

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

GetStringAsync(Uri, CancellationToken)

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

설명

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

GetStringAsync(String)

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (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입니다.

반환

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

예외

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

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

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

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

설명

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

참고

시간 제한의 경우:

적용 대상

GetStringAsync(Uri)

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<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입니다.

반환

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

예외

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

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

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

설명

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

참고

시간 제한의 경우:

적용 대상

GetStringAsync(String, CancellationToken)

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

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

반환

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

예외

requestUrinull인 경우

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

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

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

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

설명

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

참고

시간 제한의 경우:

적용 대상

GetStringAsync(Uri, CancellationToken)

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

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

반환

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

예외

requestUrinull인 경우

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

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

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

설명

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

참고

시간 제한의 경우:

적용 대상