JsonSerializer.Deserialize 메서드

참조

정의

네임스페이스:: System.Text.Json

어셈블리:: System.Text.Json.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

Deserialize(Stream, JsonTypeInfo)
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 로 읽습니다 `returnType`.
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 읽고 지정된 형식의 인스턴스로 변환합니다.
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)
Deserialize(String, JsonTypeInfo)
Deserialize(JsonDocument, JsonTypeInfo)
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
Deserialize(JsonNode, JsonTypeInfo)
Deserialize(Utf8JsonReader, JsonTypeInfo)
Deserialize(Stream, Type, JsonSerializerOptions)	단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 `returnType`. 스트림은 완료될 때 읽습니다.
Deserialize(Stream, Type, JsonSerializerContext)	단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 읽습니다 `returnType`. 스트림은 완료될 때 읽습니다.
Deserialize(JsonElement, JsonTypeInfo)
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<Byte>, JsonTypeInfo<TValue>)	단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 로 `TValue`구문 분석합니다.
Deserialize<TValue>(String, JsonSerializerOptions)	단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	단일 JSON 값을 나타내는 텍스트를 로 `TValue`구문 분석합니다.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	단일 JSON 값을 제네릭 형식 매개 변수에 지정된 유형의 인스턴스로 나타내는 텍스트를 구문 분석합니다.
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)

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

jsonTypeInfo: JsonTypeInfo

반환

Object

적용 대상

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType 또는 context가 null인 경우

JsonException

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

ArgumentException

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

NotSupportedException

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

InvalidOperationException

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

설명

의 속성 reader 이 PropertyName TokenType 또는 None인 경우 판독기는 값의 시작을 확인하기 위해 Read() 에 대한 호출을 통해 한 번 진행됩니다.

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

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

JsonReaderOptions 인스턴스를 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , AllowTrailingCommas MaxDepth및 CommentHandling 는 읽는 동안 사용됩니다.

적용 대상

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

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

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

ArgumentException

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

NotSupportedException

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

설명

의 속성 reader 이 JsonTokenType.PropertyName TokenType 또는 JsonTokenType.None인 경우 판독기는 값의 시작을 확인하기 위해 Utf8JsonReader.Read() 에 대한 호출을 통해 한 번 진행됩니다.

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

JsonReaderOptions 인스턴스를 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , JsonReaderOptions.AllowTrailingCommas JsonReaderOptions.MaxDepth및 JsonReaderOptions.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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

JsonException

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

NotSupportedException

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType이(가) null인 경우

또는

context이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

InvalidOperationException

제공된 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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType는 null 입니다.

JsonException

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

NotSupportedException

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

document이(가) null인 경우

또는

returnType이(가) null인 경우

또는

context이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

InvalidOperationException

제공된 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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

document 또는 returnType가 null인 경우

JsonException

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

NotSupportedException

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

json 또는 returnType가 null인 경우

또는

context이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

InvalidOperationException

제공된 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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

json 또는 returnType가 null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

json 또는 returnType가 null인 경우

또는

context이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

InvalidOperationException

제공된 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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType이(가) null인 경우

또는

context이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

InvalidOperationException

제공된 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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

returnType는 null 입니다.

JsonException

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

NotSupportedException

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

InvalidOperationException

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

적용 대상

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

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>

jsonTypeInfo: JsonTypeInfo

반환

Object

적용 대상

Deserialize(String, JsonTypeInfo)

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

jsonTypeInfo: JsonTypeInfo

반환

Object

적용 대상

Deserialize(JsonDocument, JsonTypeInfo)

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

jsonTypeInfo: JsonTypeInfo

반환

Object

적용 대상

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

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>

jsonTypeInfo: JsonTypeInfo

반환

Object

적용 대상

Deserialize(JsonNode, JsonTypeInfo)

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

jsonTypeInfo: JsonTypeInfo

반환

Object

적용 대상

Deserialize(Utf8JsonReader, JsonTypeInfo)

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

반환

Object

적용 대상

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

utf8Json 또는 returnType가 null인 경우

JsonException

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

NotSupportedException

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

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

반환

Object

JSON 값의 returnType 표현입니다.

예외

ArgumentNullException

utf8Json, returnType 또는 context가 null입니다.

JsonException

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

NotSupportedException

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

InvalidOperationException

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

적용 대상

Deserialize(JsonElement, JsonTypeInfo)

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

jsonTypeInfo: JsonTypeInfo

반환

Object

적용 대상

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 표현입니다.

예외

JsonException

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

ArgumentException

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

NotSupportedException

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

설명

의 속성 reader 이 PropertyName TokenType 또는 None인 경우 판독기는 값의 시작을 확인하기 위해 Read() 에 대한 호출을 통해 한 번 진행됩니다.

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

적용 대상

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 표현입니다.

예외

ArgumentNullException

document이(가) null인 경우

또는

jsonTypeInfo이(가) null인 경우

JsonException

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

NotSupportedException

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 표현입니다.

예외

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

ArgumentException

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

NotSupportedException

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

설명

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

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

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

JsonReaderOptions 인스턴스를 만드는 데 사용되는 는 Utf8JsonReader 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth및 JsonReaderOptions.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 표현입니다.

예외

ArgumentNullException

jsonTypeInfo는 null 입니다.

JsonException

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

NotSupportedException

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 표현입니다.

예외

JsonException

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

NotSupportedException

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 표현입니다.

예외

ArgumentNullException

jsonTypeInfo는 null 입니다.

JsonException

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

NotSupportedException

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 표현입니다.

예외

JsonException

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

NotSupportedException

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 표현입니다.

예외

ArgumentNullException

document는 null 입니다.

JsonException

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

NotSupportedException

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

적용 대상

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 표현입니다.

예외

JsonException

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

NotSupportedException

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

적용 대상

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 표현입니다.

예외

ArgumentNullException

json이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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 표현입니다.

예외

ArgumentNullException

json이(가) null인 경우

또는

jsonTypeInfo이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

설명

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

적용 대상

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 표현입니다.

예외

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

설명

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

적용 대상

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 표현입니다.

예외

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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 표현입니다.

예외

ArgumentNullException

utf8Json 또는 jsonTypeInfo가 null인 경우

JsonException

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

NotSupportedException

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 표현입니다.

예외

ArgumentNullException

utf8Json는 null 입니다.

JsonException

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

NotSupportedException

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 표현입니다.

예외

ArgumentNullException

json이(가) null인 경우

또는

jsonTypeInfo이(가) null인 경우

JsonException

JSON이 잘못되었습니다.

또는

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

또는

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

NotSupportedException

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

설명

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

적용 대상