JsonSerializer.Deserialize 메서드

정의

오버로드

Deserialize(Stream, JsonTypeInfo)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 jsonTypeInfo텍스트를 로 지정된 instance 읽습니다. 스트림은 완료될 때 읽습니다.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 로 returnType읽습니다.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 읽고 지정된 형식의 instance 변환합니다.

Deserialize(JsonNode, Type, JsonSerializerOptions)

JsonNode 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

Deserialize(JsonElement, Type, JsonSerializerContext)

JsonElement 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

Deserialize(JsonElement, Type, JsonSerializerOptions)

JsonElement 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

Deserialize(JsonDocument, Type, JsonSerializerContext)

JsonDocument 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

JsonDocument 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

Deserialize(String, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 텍스트를 로 returnType구문 분석합니다.

Deserialize(String, Type, JsonSerializerOptions)

단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 텍스트를 로 returnType구문 분석합니다.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

Deserialize(JsonNode, Type, JsonSerializerContext)

JsonNode 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 구문 분석합니다.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 returnType구문 분석합니다.

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 지정된 jsonTypeInfoinstance 구문 분석합니다.

Deserialize(String, JsonTypeInfo)

단일 JSON 값을 나타내는 텍스트를 로 지정된 jsonTypeInfoinstance 구문 분석합니다.

Deserialize(JsonDocument, JsonTypeInfo)

JsonDocument 단일 JSON 값을 나타내는 를 에서 지정jsonTypeInfo한 instance 변환합니다.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

단일 JSON 값을 나타내는 텍스트를 로 지정된 jsonTypeInfoinstance 구문 분석합니다.

Deserialize(JsonNode, JsonTypeInfo)

JsonNode 단일 JSON 값을 나타내는 를 에서 지정jsonTypeInfo한 instance 변환합니다.

Deserialize(Utf8JsonReader, JsonTypeInfo)

제공된 판독기에서 지정된 instance jsonTypeInfoJSON 값(개체 또는 배열 포함)을 읽습니다.

Deserialize(Stream, Type, JsonSerializerOptions)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 returnType읽습니다. 스트림은 완료될 때 읽습니다.

Deserialize(Stream, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 returnType읽습니다. 스트림은 완료될 때 읽습니다.

Deserialize(JsonElement, JsonTypeInfo)

JsonElement 단일 JSON 값을 나타내는 를 에서 지정jsonTypeInfo한 instance 변환합니다.

Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)

제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 로 TValue읽습니다.

Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)

JsonDocument 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

제공된 판독기에서 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 JSON 값 하나(개체 또는 배열 포함)를 읽어옵니다.

Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)

JsonNode 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

JsonNode 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)

JsonElement 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

JsonElement 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

JsonDocument 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)

단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

Deserialize<TValue>(String, JsonSerializerOptions)

단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 텍스트를 로 TValue구문 분석합니다.

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 TValue구문 분석합니다.

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)

단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 구문 분석합니다.

Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 TValue읽습니다. 스트림은 완료될 때 읽습니다.

Deserialize<TValue>(Stream, JsonSerializerOptions)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 TValue읽습니다. 스트림은 완료될 때 읽습니다.

Deserialize<TValue>(String, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 텍스트를 로 TValue구문 분석합니다.

Deserialize(Stream, JsonTypeInfo)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 jsonTypeInfo텍스트를 로 지정된 instance 읽습니다. 스트림은 완료될 때 읽습니다.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

utf8Json
Stream

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

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

utf8Json 또는 jsonTypeInfonull인 경우

JSON이 잘못되었거나 스트림에 남아 있는 데이터가 있습니다.

적용 대상

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 로 returnType읽습니다.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object

매개 변수

reader
Utf8JsonReader

읽을 판독기입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnType 또는 contextnull인 경우

JSON이 잘못되었거나, returnType이 JSON과 호환되지 않거나, 판독기에서 값을 읽을 수 없습니다.

reader에서 지원되지 않는 옵션을 사용하고 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

GetTypeInfo(Type) 제공된 의 메서드가 context 에 대해 returnType호환 JsonTypeInfo 되는 을 반환하지 않았습니다.

설명

의 속성 readerPropertyNameTokenType 또는 None이면 판독기는 에 대한 호출을 통해 Read() 고급화되어 값의 시작을 결정합니다.

이 메서드가 완료되면 는 reader JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.

이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.

JsonReaderOptions 의 instance 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , AllowTrailingCommas, MaxDepthCommentHandling 는 읽는 동안 사용됩니다.

적용 대상

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 읽고 지정된 형식의 instance 변환합니다.

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

reader
Utf8JsonReader

JSON을 읽을 판독기입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

읽는 동안 직렬 변환기 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnType이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

판독기에서 값을 읽을 수 없습니다.

reader에서 지원되지 않는 옵션을 사용하고 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

의 속성 readerJsonTokenType.PropertyNameTokenType 또는 JsonTokenType.None이면 판독기는 에 대한 호출을 통해 Utf8JsonReader.Read() 고급화되어 값의 시작을 결정합니다.

이 메서드가 완료되면 는 reader JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.

이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.

JsonReaderOptions 의 instance 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthJsonReaderOptions.CommentHandling 는 읽는 동안 사용됩니다.

자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.

적용 대상

Deserialize(JsonNode, Type, JsonSerializerOptions)

JsonNode 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

node
JsonNode

변환할 JsonNode입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnType가 JSON과 호환되지 않습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize(JsonElement, Type, JsonSerializerContext)

JsonElement 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Object

매개 변수

element
JsonElement

변환할 JsonElement입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnTypenull입니다.

또는

context이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

제공된 context 의 메서드는 GetTypeInfo(Type) 변환할 형식에 대해 를 반환합니다null.

적용 대상

Deserialize(JsonElement, Type, JsonSerializerOptions)

JsonElement 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

element
JsonElement

변환할 JsonElement입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnTypenull입니다.

returnType가 JSON과 호환되지 않습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize(JsonDocument, Type, JsonSerializerContext)

JsonDocument 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Object

매개 변수

document
JsonDocument

변환할 JsonDocument입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

documentnull입니다.

또는

returnTypenull입니다.

또는

context이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

제공된 context 의 메서드는 GetTypeInfo(Type) 변환할 형식에 대해 를 반환합니다null.

적용 대상

Deserialize(JsonDocument, Type, JsonSerializerOptions)

JsonDocument 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

document
JsonDocument

변환할 JsonDocument입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

document 또는 returnTypenull인 경우

returnType가 JSON과 호환되지 않습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize(String, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 텍스트를 로 returnType구문 분석합니다.

public:
 static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object

매개 변수

json
String

구문 분석할 JSON 텍스트입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

json 또는 returnTypenull인 경우

또는

context이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

제공된 context 의 메서드는 GetTypeInfo(Type) 변환할 형식에 대해 를 반환합니다null.

설명

String 구현이 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상

Deserialize(String, Type, JsonSerializerOptions)

단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

json
String

구문 분석할 JSON 텍스트입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

json 또는 returnTypenull인 경우

JSON이 잘못되었습니다.

또는

TValue가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

String 구현이 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.

적용 대상

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 텍스트를 로 returnType구문 분석합니다.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object

매개 변수

json
ReadOnlySpan<Char>

구문 분석할 JSON 텍스트입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

json 또는 returnTypenull인 경우

또는

context이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

제공된 context 의 메서드는 GetTypeInfo(Type) 변환할 형식에 대해 를 반환합니다null.

설명

String 구현이 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

json
ReadOnlySpan<Char>

구문 분석할 JSON 텍스트입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnType이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

범위에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

UTF-16 범위를 사용하는 것은 기본적으로 UTF-8을 사용하기 때문에 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상

Deserialize(JsonNode, Type, JsonSerializerContext)

JsonNode 단일 JSON 값을 나타내는 를 로 returnType변환합니다.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Object

매개 변수

node
JsonNode

변환할 JsonNode입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnTypenull입니다.

또는

context이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

제공된 context 의 메서드는 GetTypeInfo(Type) 변환할 형식에 대해 를 반환합니다null.

적용 대상

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

단일 JSON 값을 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 구문 분석합니다.

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

utf8Json
ReadOnlySpan<Byte>

구문 분석할 JSON 텍스트입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnType이(가) null인 경우

JSON이 잘못되었습니다.

또는

returnType가 JSON과 호환되지 않습니다.

또는

범위에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.

적용 대상

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 returnType구문 분석합니다.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object

매개 변수

utf8Json
ReadOnlySpan<Byte>

구문 분석할 JSON 텍스트입니다.

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnTypenull입니다.

JSON이 잘못되었거나, returnType JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

GetTypeInfo(Type) 제공된 의 메서드가 context 에 대해 returnType호환 JsonTypeInfo 되는 을 반환하지 않았습니다.

적용 대상

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 지정된 jsonTypeInfoinstance 구문 분석합니다.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

utf8Json
ReadOnlySpan<Byte>

구문 분석할 JSON 텍스트입니다.

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

JSON이 잘못되었거나 버퍼에 남아 있는 데이터가 있습니다.

적용 대상

Deserialize(String, JsonTypeInfo)

단일 JSON 값을 나타내는 텍스트를 로 지정된 jsonTypeInfoinstance 구문 분석합니다.

public:
 static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

json
String

구문 분석할 JSON 텍스트입니다.

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

jsonnull입니다.

또는

jsonTypeInfo이(가) null인 경우

JSON이 잘못되었습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

설명

String 구현이 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상

Deserialize(JsonDocument, JsonTypeInfo)

JsonDocument 단일 JSON 값을 나타내는 를 에서 지정jsonTypeInfo한 instance 변환합니다.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

document
JsonDocument

변환할 JsonDocument입니다.

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

documentnull입니다.

또는

jsonTypeInfonull입니다.

적용 대상

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

단일 JSON 값을 나타내는 텍스트를 로 지정된 jsonTypeInfoinstance 구문 분석합니다.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

json
ReadOnlySpan<Char>

구문 분석할 JSON 텍스트입니다.

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

jsonTypeInfo이(가) null인 경우

JSON이 잘못되었습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

설명

String 구현이 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상

Deserialize(JsonNode, JsonTypeInfo)

JsonNode 단일 JSON 값을 나타내는 를 에서 지정jsonTypeInfo한 instance 변환합니다.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

node
JsonNode

변환할 JsonNode입니다.

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

jsonTypeInfonull입니다.

적용 대상

Deserialize(Utf8JsonReader, JsonTypeInfo)

제공된 판독기에서 지정된 instance jsonTypeInfoJSON 값(개체 또는 배열 포함)을 읽습니다.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

reader
Utf8JsonReader

읽을 판독기입니다.

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

JSON이 잘못되었거나, jsonTypeInfo이 JSON과 호환되지 않거나, 판독기에서 값을 읽을 수 없습니다.

reader에서 지원되지 않는 옵션을 사용하고 있습니다.

설명

의 속성 readerPropertyNameTokenType 또는 None이면 판독기는 에 대한 호출을 통해 Read() 고급화되어 값의 시작을 결정합니다.

이 메서드가 완료되면 는 reader JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.

이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.

JsonReaderOptions 의 instance 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , AllowTrailingCommas, MaxDepthCommentHandling 는 읽는 동안 사용됩니다.

적용 대상

Deserialize(Stream, Type, JsonSerializerOptions)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 returnType읽습니다. 스트림은 완료될 때 읽습니다.

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

매개 변수

utf8Json
Stream

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

returnType
Type

변환하고 반환할 개체의 형식입니다.

options
JsonSerializerOptions

읽는 동안 동작을 컨트롤하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

utf8Json 또는 returnTypenull인 경우

JSON이 잘못되었거나, 가 returnType JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize(Stream, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 returnType읽습니다. 스트림은 완료될 때 읽습니다.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Object

매개 변수

utf8Json
Stream

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

returnType
Type

변환하고 반환할 개체의 형식입니다.

context
JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

JSON 값의 returnType 표현입니다.

예외

utf8Json, returnType 또는 contextnull입니다.

JSON이 잘못되었거나, 가 returnType JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.

returnType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

GetTypeInfo(Type) 제공된 의 메서드가 context 에 대해 returnType호환 JsonTypeInfo 되는 을 반환하지 않았습니다.

적용 대상

Deserialize(JsonElement, JsonTypeInfo)

JsonElement 단일 JSON 값을 나타내는 를 에서 지정jsonTypeInfo한 instance 변환합니다.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As Object

매개 변수

element
JsonElement

변환할 JsonElement입니다.

jsonTypeInfo
JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

jsonTypeInfonull입니다.

적용 대상

Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)

제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 로 TValue읽습니다.

public:
generic <typename TValue>
 static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

reader
Utf8JsonReader

읽을 판독기입니다.

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

JSON이 잘못되었거나, TValue이 JSON과 호환되지 않거나, 판독기에서 값을 읽을 수 없습니다.

reader에서 지원되지 않는 옵션을 사용하고 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

의 속성 readerPropertyNameTokenType 또는 None이면 판독기는 에 대한 호출을 통해 Read() 고급화되어 값의 시작을 결정합니다.

이 메서드가 완료되면 는 reader JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.

이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.

JsonReaderOptions 의 instance 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , AllowTrailingCommas, MaxDepthCommentHandling 는 읽는 동안 사용됩니다.

적용 대상

Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)

JsonDocument 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

document
JsonDocument

변환할 JsonDocument입니다.

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

documentnull입니다.

또는

jsonTypeInfonull입니다.

TValue가 JSON과 호환되지 않습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

제공된 판독기에서 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 JSON 값 하나(개체 또는 배열 포함)를 읽어옵니다.

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

JSON 값의 대상 형식입니다.

매개 변수

reader
Utf8JsonReader

JSON을 읽을 판독기입니다.

options
JsonSerializerOptions

읽는 동안 직렬 변환기 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

JSON이 잘못되었습니다.

또는

TValue가 JSON과 호환되지 않습니다.

또는

판독기에서 값을 읽을 수 없습니다.

reader에서 지원되지 않는 옵션을 사용합니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

의 속성 readerJsonTokenType.PropertyNameTokenType 또는 JsonTokenType.None이면 판독기는 에 대한 호출을 통해 Utf8JsonReader.Read() 고급화되어 값의 시작을 결정합니다.

이 메서드가 완료되면 는 reader JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.

이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.

JsonReaderOptions 의 instance 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthJsonReaderOptions.CommentHandling 는 읽는 동안 사용됩니다.

자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.

적용 대상

Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)

JsonNode 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

node
JsonNode

변환할 JsonNode입니다.

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

jsonTypeInfonull입니다.

TValue가 JSON과 호환되지 않습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

JsonNode 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

node
JsonNode

변환할 JsonNode입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

TValue가 JSON과 호환되지 않습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)

JsonElement 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

element
JsonElement

변환할 JsonElement입니다.

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

jsonTypeInfonull입니다.

TValue가 JSON과 호환되지 않습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

JsonElement 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

element
JsonElement

변환할 JsonElement입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

TValue가 JSON과 호환되지 않습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

JsonDocument 단일 JSON 값을 나타내는 를 로 TValue변환합니다.

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

document
JsonDocument

변환할 JsonDocument입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

documentnull입니다.

TValue가 JSON과 호환되지 않습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)

단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Value
Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

json
ReadOnlySpan<Char>

구문 분석할 JSON 텍스트입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

JSON이 잘못되었습니다.

또는

TValue가 JSON과 호환되지 않습니다.

또는

범위에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

UTF-16 범위를 사용하는 것은 기본적으로 UTF-8을 사용하기 때문에 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상

Deserialize<TValue>(String, JsonSerializerOptions)

단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.

public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

JSON 값의 대상 형식입니다.

매개 변수

json
String

구문 분석할 JSON 텍스트입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

json이(가) null인 경우

JSON이 잘못되었습니다.

또는

TValue가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

String 구현에서 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.

적용 대상

Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 텍스트를 로 TValue구문 분석합니다.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

json
ReadOnlySpan<Char>

구문 분석할 JSON 텍스트입니다.

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

jsonnull입니다.

또는

jsonTypeInfo이(가) null인 경우

JSON이 잘못되었습니다.

또는

TValue가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

String 구현에서 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 TValue구문 분석합니다.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

utf8Json
ReadOnlySpan<Byte>

구문 분석할 JSON 텍스트입니다.

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

JSON이 잘못되었거나, TValue JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)

단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 UTF-8로 인코딩된 텍스트를 구문 분석합니다.

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

UTF-8로 인코딩된 텍스트의 대상 형식입니다.

매개 변수

utf8Json
ReadOnlySpan<Byte>

구문 분석할 JSON 텍스트입니다.

options
JsonSerializerOptions

구문 분석하는 동안 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

JSON이 잘못되었습니다.

또는

TValue가 JSON과 호환되지 않습니다.

또는

범위에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.

적용 대상

Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 TValue. 스트림은 완료될 때 읽습니다.

public:
generic <typename TValue>
 static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

utf8Json
Stream

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

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

utf8Json 또는 jsonTypeInfonull인 경우

JSON이 잘못되었거나, TValue JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(Stream, JsonSerializerOptions)

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 TValue. 스트림은 완료될 때 읽습니다.

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

utf8Json
Stream

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

options
JsonSerializerOptions

읽는 동안 동작을 컨트롤하는 옵션입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

utf8Jsonnull입니다.

JSON이 잘못되었거나, TValue JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

적용 대상

Deserialize<TValue>(String, JsonTypeInfo<TValue>)

단일 JSON 값을 나타내는 텍스트를 로 TValue구문 분석합니다.

public:
generic <typename TValue>
 static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

형식 매개 변수

TValue

JSON 값을 역직렬화할 형식입니다.

매개 변수

json
String

구문 분석할 JSON 텍스트입니다.

jsonTypeInfo
JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

TValue

JSON 값의 TValue 표현입니다.

예외

jsonnull입니다.

또는

jsonTypeInfo이(가) null인 경우

JSON이 잘못되었습니다.

또는

TValue가 JSON과 호환되지 않습니다.

또는

문자열에 단일 JSON 값을 초과하는 남은 데이터가 있습니다.

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.

설명

String 구현에서 기본적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.

적용 대상