JsonSerializer.DeserializeAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 |
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 지정된 |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 비동기적으로 읽습니다. 완료될 때까지 스트림을 읽습니다. |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 비동기적으로 읽습니다. 완료될 때까지 스트림을 읽습니다. |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 returnType.
스트림은 완료될 때 읽습니다.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)매개 변수
- utf8Json
- Stream
구문 분석할 JSON 데이터입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
- cancellationToken
- CancellationToken
CancellationToken 읽기 작업을 취소하는 데 사용할 수 있는 입니다.
반환
JSON 값의 returnType 표현입니다.
예외
utf8Json, returnType 또는 context가 null입니다.
JSON이 잘못되었거나, 가 returnType JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.
returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
GetTypeInfo(Type) 제공된 의 메서드가 context 에 대해 호환 JsonTypeInfo 되는 를 returnType반환하지 않았습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Deserialize(Stream, Type, JsonSerializerContext)된 예외를 참조하세요.
적용 대상
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 지정된 jsonTypeInfoinstance 읽습니다.
스트림은 완료될 때 읽습니다.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)매개 변수
- utf8Json
- Stream
구문 분석할 JSON 데이터입니다.
- jsonTypeInfo
- JsonTypeInfo
변환할 형식에 대한 메타데이터입니다.
- cancellationToken
- CancellationToken
CancellationToken 읽기 작업을 취소하는 데 사용할 수 있는 입니다.
반환
JSON 값의 jsonTypeInfo 표현입니다.
예외
utf8Json 또는 jsonTypeInfo가 null인 경우
JSON이 잘못되었거나 Stream에 데이터가 남아 있는 경우
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
적용 대상
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 비동기적으로 읽습니다. 완료될 때까지 스트림을 읽습니다.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.ValueTask<object> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Shared Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)매개 변수
- utf8Json
- Stream
구문 분석할 JSON 데이터입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- options
- JsonSerializerOptions
읽는 동안 동작을 컨트롤하는 옵션입니다.
- cancellationToken
- CancellationToken
읽기 작업을 취소하는 데 사용할 수 있는 취소 토큰입니다.
반환
JSON 값의 returnType 표현입니다.
예외
utf8Json 또는 returnType가 null인 경우
returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Deserialize(Stream, Type, JsonSerializerOptions)된 예외를 참조하세요.
적용 대상
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 TValue.
스트림은 완료될 때 읽습니다.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)형식 매개 변수
- TValue
JSON 값을 역직렬화할 형식입니다.
매개 변수
- utf8Json
- Stream
구문 분석할 JSON 데이터입니다.
- jsonTypeInfo
- JsonTypeInfo<TValue>
변환할 형식에 대한 메타데이터입니다.
- cancellationToken
- CancellationToken
CancellationToken 읽기 작업을 취소하는 데 사용할 수 있는 입니다.
반환
JSON 값의 TValue 표현입니다.
예외
utf8Json 또는 jsonTypeInfo가 null인 경우
JSON이 잘못되었거나, TValue JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
적용 대상
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 비동기적으로 읽습니다. 완료될 때까지 스트림을 읽습니다.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.ValueTask<TValue> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>Public Shared Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)형식 매개 변수
- TValue
JSON 값의 대상 형식입니다.
매개 변수
- utf8Json
- Stream
구문 분석할 JSON 데이터입니다.
- options
- JsonSerializerOptions
읽는 동안 동작을 컨트롤하는 옵션입니다.
- cancellationToken
- CancellationToken
읽기 작업을 취소하는 데 사용할 수 있는 토큰입니다.
반환
JSON 값의 TValue 표현입니다.
예외
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
utf8Json가 null입니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기