JsonDocument.ParseAsync 메서드

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

Source:

JsonDocument.Parse.cs

Stream을 단일 JSON 값을 나타내는 UTF-8로 인코딩된 데이터로 구문 분석하여 JsonDocument로 변환합니다. 완료될 때까지 스트림을 읽습니다.

public static System.Threading.Tasks.Task<System.Text.Json.JsonDocument> ParseAsync (System.IO.Stream utf8Json, System.Text.Json.JsonDocumentOptions options = default, System.Threading.CancellationToken cancellationToken = default);

static member ParseAsync : System.IO.Stream * System.Text.Json.JsonDocumentOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Text.Json.JsonDocument>

Public Shared Function ParseAsync (utf8Json As Stream, Optional options As JsonDocumentOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of JsonDocument)

매개 변수

utf8Json

Stream

구문 분석할 JSON 데이터입니다.

options

JsonDocumentOptions

구문 분석하는 동안 판독기 동작을 제어하는 옵션입니다.

cancellationToken

CancellationToken

취소 요청을 모니터링할 토큰입니다.

반환

Task<JsonDocument>

JSON 값의 JsonDocument 표현을 생성하는 작업입니다.

예외

JsonException

utf8Json은 유효한 단일 JSON 값을 나타내지 않습니다.

ArgumentException

options에 지원되지 않는 옵션이 있습니다.

OperationCanceledException

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

설명

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Parse(Stream, JsonDocumentOptions)된 예외를 참조하세요.