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로 인코딩된 텍스트를 로 지정된 jsonTypeInfo
instance 읽습니다.
스트림은 완료될 때 읽습니다.
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
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기