다음을 통해 공유


JsonSerializer.Deserialize 메서드

정의

오버로드

Deserialize(Stream, JsonTypeInfo)

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

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

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

Deserialize(JsonNode, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 JsonNodereturnType변환합니다.

Deserialize(JsonNode, Type, JsonSerializerOptions)

단일 JSON 값을 나타내는 JsonNodereturnType변환합니다.

Deserialize(JsonElement, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 JsonElementreturnType변환합니다.

Deserialize(JsonElement, Type, JsonSerializerOptions)

단일 JSON 값을 나타내는 JsonElementreturnType변환합니다.

Deserialize(JsonDocument, Type, JsonSerializerContext)

단일 JSON 값을 나타내는 JsonDocumentreturnType변환합니다.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

단일 JSON 값을 나타내는 JsonDocumentreturnType변환합니다.

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(Utf8JsonReader, Type, JsonSerializerOptions)

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

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

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

Deserialize(Stream, Type, JsonSerializerContext)

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

Deserialize(Stream, Type, JsonSerializerOptions)

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

Deserialize(Utf8JsonReader, JsonTypeInfo)

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

Deserialize(JsonNode, JsonTypeInfo)

단일 JSON 값을 나타내는 JsonNodejsonTypeInfo지정된 인스턴스로 변환합니다.

Deserialize(JsonElement, JsonTypeInfo)

단일 JSON 값을 나타내는 JsonElementjsonTypeInfo지정된 인스턴스로 변환합니다.

Deserialize(JsonDocument, JsonTypeInfo)

단일 JSON 값을 나타내는 JsonDocumentjsonTypeInfo지정된 인스턴스로 변환합니다.

Deserialize(String, JsonTypeInfo)

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

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

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

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

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

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

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

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

단일 JSON 값을 나타내는 JsonElementTValue변환합니다.

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

단일 JSON 값을 나타내는 JsonElementTValue변환합니다.

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

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

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

단일 JSON 값을 나타내는 JsonNodeTValue변환합니다.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

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

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

단일 JSON 값을 나타내는 JsonDocumentTValue변환합니다.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

단일 JSON 값을 나타내는 JsonNodeTValue변환합니다.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

단일 JSON 값을 나타내는 JsonDocumentTValue변환합니다.

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

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

Deserialize<TValue>(String, JsonSerializerOptions)

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

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

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

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)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 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

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

jsonTypeInfo
JsonTypeInfo

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

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

utf8Json 또는 jsonTypeInfonull.

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

적용 대상

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs

제공된 판독기에서 하나의 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 없습니다.

제공된 contextGetTypeInfo(Type) 메서드가 returnType호환되는 JsonTypeInfo 반환하지 않았습니다.

설명

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

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

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

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

적용 대상

Deserialize(JsonNode, Type, JsonSerializerContext)

Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs

단일 JSON 값을 나타내는 JsonNodereturnType변환합니다.

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

예외

returnType null.

-또는-

context null.

JSON이 잘못되었습니다.

-또는-

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

-또는-

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

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

제공된 contextGetTypeInfo(Type) 메서드는 변환할 형식에 대한 null 반환합니다.

적용 대상

Deserialize(JsonNode, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs

단일 JSON 값을 나타내는 JsonNodereturnType변환합니다.

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)

Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs

단일 JSON 값을 나타내는 JsonElementreturnType변환합니다.

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

예외

returnType null.

-또는-

context null.

JSON이 잘못되었습니다.

-또는-

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

-또는-

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

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

제공된 contextGetTypeInfo(Type) 메서드는 변환할 형식에 대한 null 반환합니다.

적용 대상

Deserialize(JsonElement, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs

단일 JSON 값을 나타내는 JsonElementreturnType변환합니다.

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

예외

returnType null.

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

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

적용 대상

Deserialize(JsonDocument, Type, JsonSerializerContext)

Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs

단일 JSON 값을 나타내는 JsonDocumentreturnType변환합니다.

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

예외

document null.

-또는-

returnType null.

-또는-

context null.

JSON이 잘못되었습니다.

-또는-

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

-또는-

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

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

제공된 contextGetTypeInfo(Type) 메서드는 변환할 형식에 대한 null 반환합니다.

적용 대상

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs

단일 JSON 값을 나타내는 JsonDocumentreturnType변환합니다.

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)

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 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 없습니다.

제공된 contextGetTypeInfo(Type) 메서드는 변환할 형식에 대한 null 반환합니다.

설명

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

적용 대상

Deserialize(String, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 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 없습니다.

설명

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

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

적용 대상

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 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 없습니다.

제공된 contextGetTypeInfo(Type) 메서드는 변환할 형식에 대한 null 반환합니다.

설명

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

적용 대상

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 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(Utf8JsonReader, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs

제공된 판독기에서 하나의 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

읽는 동안 serializer 동작을 제어하는 옵션입니다.

반환

JSON 값의 returnType 표현입니다.

예외

returnType null.

JSON이 잘못되었습니다.

-또는-

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

-또는-

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

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

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

설명

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

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

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

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

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

적용 대상

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs

단일 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(Stream, Type, JsonSerializerContext)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

단일 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 없습니다.

제공된 contextGetTypeInfo(Type) 메서드가 returnType호환되는 JsonTypeInfo 반환하지 않았습니다.

적용 대상

Deserialize(Stream, Type, JsonSerializerOptions)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

단일 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(Utf8JsonReader, JsonTypeInfo)

Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs

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

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 지원되지 않는 옵션을 사용하고 있습니다.

설명

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

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

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

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

적용 대상

Deserialize(JsonNode, JsonTypeInfo)

Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs

단일 JSON 값을 나타내는 JsonNodejsonTypeInfo지정된 인스턴스로 변환합니다.

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

예외

jsonTypeInfo null.

적용 대상

Deserialize(JsonElement, JsonTypeInfo)

Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs

단일 JSON 값을 나타내는 JsonElementjsonTypeInfo지정된 인스턴스로 변환합니다.

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

예외

jsonTypeInfo null.

적용 대상

Deserialize(JsonDocument, JsonTypeInfo)

Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs

단일 JSON 값을 나타내는 JsonDocumentjsonTypeInfo지정된 인스턴스로 변환합니다.

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

예외

document null.

-또는-

jsonTypeInfo null.

적용 대상

Deserialize(String, JsonTypeInfo)

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 JSON 값을 나타내는 텍스트를 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

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

jsonTypeInfo
JsonTypeInfo

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

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

json null.

-또는-

jsonTypeInfo null.

JSON이 잘못되었습니다.

-또는-

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

설명

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

적용 대상

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 JSON 값을 나타내는 텍스트를 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>

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

jsonTypeInfo
JsonTypeInfo

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

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

jsonTypeInfo null.

JSON이 잘못되었습니다.

-또는-

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

설명

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

적용 대상

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs

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

예외

returnType null.

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

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

제공된 contextGetTypeInfo(Type) 메서드가 returnType호환되는 JsonTypeInfo 반환하지 않았습니다.

적용 대상

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs

단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 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>

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

jsonTypeInfo
JsonTypeInfo

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

반환

JSON 값의 jsonTypeInfo 표현입니다.

예외

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

적용 대상

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs

단일 JSON 값을 나타내는 JsonElementTValue변환합니다.

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>(JsonElement, JsonTypeInfo<TValue>)

Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs
Source:
JsonSerializer.Read.Element.cs

단일 JSON 값을 나타내는 JsonElementTValue변환합니다.

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

예외

jsonTypeInfo null.

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

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

적용 대상

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

Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs

제공된 판독기에서 하나의 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 없습니다.

설명

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

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

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

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

적용 대상

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

Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs

단일 JSON 값을 나타내는 JsonNodeTValue변환합니다.

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

예외

jsonTypeInfo null.

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

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

적용 대상

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs
Source:
JsonSerializer.Read.Utf8JsonReader.cs

제공된 판독기에서 제네릭 형식 매개 변수로 지정된 형식의 인스턴스로 하나의 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 없습니다.

설명

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

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

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

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

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

적용 대상

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

Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs

단일 JSON 값을 나타내는 JsonDocumentTValue변환합니다.

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

예외

document null.

-또는-

jsonTypeInfo null.

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

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

적용 대상

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs

단일 JSON 값을 나타내는 JsonNodeTValue변환합니다.

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>(JsonDocument, JsonSerializerOptions)

Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs

단일 JSON 값을 나타내는 JsonDocumentTValue변환합니다.

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

예외

document null.

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

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

적용 대상

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

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

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

예외

json null.

-또는-

jsonTypeInfo null.

JSON이 잘못되었습니다.

-또는-

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

-또는-

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

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

설명

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

적용 대상

Deserialize<TValue>(String, JsonSerializerOptions)

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 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이 잘못되었습니다.

-또는-

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

-또는-

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

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

설명

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

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

적용 대상

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

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

단일 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>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs

단일 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)

Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs
Source:
JsonSerializer.Read.Span.cs

단일 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>)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

단일 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)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

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

예외

utf8Json null.

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

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

적용 대상

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

Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs
Source:
JsonSerializer.Read.String.cs

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

예외

json null.

-또는-

jsonTypeInfo null.

JSON이 잘못되었습니다.

-또는-

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

-또는-

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

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

설명

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

적용 대상