JsonSerializer.DeserializeAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 지정된 형식의 인스턴스로 비동기적으로 읽습니다. 스트림은 완료될 때 읽습니다. |
| DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 제네릭 형식 매개 변수로 지정된 형식의 인스턴스로 비동기적으로 읽습니다. 스트림은 완료될 때 읽습니다. |
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 jsonTypeInfo지정된 인스턴스로 읽습니다.
스트림은 완료될 때 읽습니다.
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 또는 jsonTypeInfonull.
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 또는 returnTypenull.
returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 Deserialize(Stream, Type, JsonSerializerOptions)throw된 예외를 참조하세요.
적용 대상
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또는 contextnull.
JSON이 잘못되었거나, returnType JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.
returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 contextGetTypeInfo(Type) 메서드가 returnType호환되는 JsonTypeInfo 반환하지 않았습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 Deserialize(Stream, Type, JsonSerializerContext)throw된 예외를 참조하세요.
적용 대상
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 또는 jsonTypeInfonull.
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