JsonSerializer.Deserialize 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
Deserialize(Stream, JsonTypeInfo)
단일 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
또는 jsonTypeInfo
null
.
JSON이 잘못되었거나 스트림에 남아 있는 데이터가 있습니다.
적용 대상
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)
제공된 판독기에서 하나의 JSON 값(개체 또는 배열 포함)을 returnType
읽습니다.
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object
매개 변수
- reader
- Utf8JsonReader
읽을 판독기입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
반환
JSON 값의 returnType
표현입니다.
예외
returnType
또는 context
null
.
JSON이 잘못되었거나, returnType
JSON과 호환되지 않거나, 판독기에서 값을 읽을 수 없습니다.
reader
지원되지 않는 옵션을 사용하고 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 context
GetTypeInfo(Type) 메서드가 returnType
호환되는 JsonTypeInfo 반환하지 않았습니다.
설명
reader
TokenType 속성이 PropertyName 또는 None경우 판독기는 값의 시작을 확인하기 위해 Read() 한 번의 호출로 진행됩니다.
이 메서드가 완료되면 reader
JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.
이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후에도 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.
Utf8JsonReader 인스턴스를 만드는 데 사용되는 JsonReaderOptions 충돌할 때 JsonSerializerOptions 우선합니다. 따라서 AllowTrailingCommas, MaxDepth및 CommentHandling 읽는 동안 사용됩니다.
적용 대상
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
매개 변수
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
반환
JSON 값의 returnType
표현입니다.
예외
JSON이 잘못되었습니다.
-또는-
returnType
JSON과 호환되지 않습니다.
-또는-
문자열에 단일 JSON 값을 초과하는 나머지 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 context
GetTypeInfo(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
매개 변수
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- options
- JsonSerializerOptions
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 returnType
표현입니다.
예외
returnType
JSON과 호환되지 않습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize(JsonElement, Type, JsonSerializerContext)
단일 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
표현입니다.
예외
JSON이 잘못되었습니다.
-또는-
returnType
JSON과 호환되지 않습니다.
-또는-
문자열에 단일 JSON 값을 초과하는 나머지 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 context
GetTypeInfo(Type) 메서드는 변환할 형식에 대한 null
반환합니다.
적용 대상
Deserialize(JsonElement, Type, JsonSerializerOptions)
단일 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)
단일 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
표현입니다.
예외
JSON이 잘못되었습니다.
-또는-
returnType
JSON과 호환되지 않습니다.
-또는-
문자열에 단일 JSON 값을 초과하는 나머지 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 context
GetTypeInfo(Type) 메서드는 변환할 형식에 대한 null
반환합니다.
적용 대상
Deserialize(JsonDocument, Type, JsonSerializerOptions)
단일 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
또는 returnType
null
.
returnType
JSON과 호환되지 않습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize(String, Type, JsonSerializerContext)
단일 JSON 값을 나타내는 텍스트를 returnType
구문 분석합니다.
public:
static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object
매개 변수
- json
- String
구문 분석할 JSON 텍스트입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
반환
JSON 값의 returnType
표현입니다.
예외
JSON이 잘못되었습니다.
-또는-
returnType
JSON과 호환되지 않습니다.
-또는-
문자열에 단일 JSON 값을 초과하는 나머지 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 context
GetTypeInfo(Type) 메서드는 변환할 형식에 대한 null
반환합니다.
설명
구현은 기본적으로 UTF-8을 사용하기 때문에 String 사용하는 것이 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
적용 대상
Deserialize(String, Type, JsonSerializerOptions)
단일 JSON 값을 나타내는 텍스트를 지정된 형식의 인스턴스로 구문 분석합니다.
public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
매개 변수
- json
- String
구문 분석할 JSON 텍스트입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- options
- JsonSerializerOptions
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 returnType
표현입니다.
예외
json
또는 returnType
null
.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
구현은 기본적으로 UTF-8을 사용하기 때문에 String 사용하는 것이 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
단일 JSON 값을 나타내는 텍스트를 returnType
구문 분석합니다.
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object
매개 변수
- json
- ReadOnlySpan<Char>
구문 분석할 JSON 텍스트입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
반환
JSON 값의 returnType
표현입니다.
예외
JSON이 잘못되었습니다.
-또는-
returnType
JSON과 호환되지 않습니다.
-또는-
문자열에 단일 JSON 값을 초과하는 나머지 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 context
GetTypeInfo(Type) 메서드는 변환할 형식에 대한 null
반환합니다.
설명
구현은 기본적으로 UTF-8을 사용하기 때문에 String 사용하는 것이 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
적용 대상
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)
단일 JSON 값을 나타내는 텍스트를 지정된 형식의 인스턴스로 구문 분석합니다.
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
매개 변수
- json
- ReadOnlySpan<Char>
구문 분석할 JSON 텍스트입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- options
- JsonSerializerOptions
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 returnType
표현입니다.
예외
returnType
null
.
JSON이 잘못되었습니다.
-또는-
returnType
JSON과 호환되지 않습니다.
-또는-
범위에는 단일 JSON 값을 초과하는 나머지 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
UTF-16 범위를 사용하는 것은 구현이 기본적으로 UTF-8을 사용하기 때문에 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
적용 대상
Deserialize(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
읽는 동안 serializer 동작을 제어하는 옵션입니다.
반환
JSON 값의 returnType
표현입니다.
예외
returnType
null
.
reader
지원되지 않는 옵션을 사용하고 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
reader
TokenType 속성이 JsonTokenType.PropertyName 또는 JsonTokenType.None경우 판독기는 값의 시작을 확인하기 위해 Utf8JsonReader.Read() 한 번의 호출로 진행됩니다.
이 메서드가 완료되면 reader
JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.
이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후에도 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.
Utf8JsonReader 인스턴스를 만드는 데 사용되는 JsonReaderOptions 충돌할 때 JsonSerializerOptions 우선합니다. 따라서 JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth및 JsonReaderOptions.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)
단일 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
또는 context
null
.
JSON이 잘못되었거나, returnType
JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
제공된 context
GetTypeInfo(Type) 메서드가 returnType
호환되는 JsonTypeInfo 반환하지 않았습니다.
적용 대상
Deserialize(Stream, Type, JsonSerializerOptions)
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 returnType
읽습니다.
스트림은 완료될 때 읽습니다.
public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
매개 변수
- utf8Json
- Stream
구문 분석할 JSON 데이터입니다.
- returnType
- Type
변환하고 반환할 개체의 형식입니다.
- options
- JsonSerializerOptions
읽는 동안 동작을 제어하는 옵션입니다.
반환
JSON 값의 returnType
표현입니다.
예외
utf8Json
또는 returnType
null
.
JSON이 잘못되었거나, returnType
JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.
returnType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize(Utf8JsonReader, JsonTypeInfo)
제공된 판독기에서 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, MaxDepth및 CommentHandling 읽는 동안 사용됩니다.
적용 대상
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
매개 변수
- jsonTypeInfo
- JsonTypeInfo
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 jsonTypeInfo
표현입니다.
예외
jsonTypeInfo
null
.
적용 대상
Deserialize(JsonElement, JsonTypeInfo)
단일 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)
단일 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
표현입니다.
예외
적용 대상
Deserialize(String, JsonTypeInfo)
단일 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
표현입니다.
예외
설명
구현은 기본적으로 UTF-8을 사용하기 때문에 String 사용하는 것이 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
적용 대상
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
단일 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
.
설명
구현은 기본적으로 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 없습니다.
제공된 context
GetTypeInfo(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)
단일 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
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
TValue
JSON과 호환되지 않습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
단일 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>
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 TValue
표현입니다.
예외
jsonTypeInfo
null
.
TValue
JSON과 호환되지 않습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
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>
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 TValue
표현입니다.
예외
JSON이 잘못되었거나, TValue
JSON과 호환되지 않거나, 판독기에서 값을 읽을 수 없습니다.
reader
지원되지 않는 옵션을 사용하고 있습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
reader
TokenType 속성이 PropertyName 또는 None경우 판독기는 값의 시작을 확인하기 위해 Read() 한 번의 호출로 진행됩니다.
이 메서드가 완료되면 reader
JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.
이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후에도 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.
Utf8JsonReader 인스턴스를 만드는 데 사용되는 JsonReaderOptions 충돌할 때 JsonSerializerOptions 우선합니다. 따라서 AllowTrailingCommas, MaxDepth및 CommentHandling 읽는 동안 사용됩니다.
적용 대상
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 값을 역직렬화할 형식입니다.
매개 변수
- jsonTypeInfo
- JsonTypeInfo<TValue>
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 TValue
표현입니다.
예외
jsonTypeInfo
null
.
TValue
JSON과 호환되지 않습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)
제공된 판독기에서 제네릭 형식 매개 변수로 지정된 형식의 인스턴스로 하나의 JSON 값(개체 또는 배열 포함)을 읽습니다.
public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
형식 매개 변수
- TValue
JSON 값의 대상 형식입니다.
매개 변수
- reader
- Utf8JsonReader
JSON을 읽을 판독기입니다.
- options
- JsonSerializerOptions
읽는 동안 직렬 변환기 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
reader
지원되지 않는 옵션을 사용합니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
reader
TokenType 속성이 JsonTokenType.PropertyName 또는 JsonTokenType.None경우 판독기는 값의 시작을 확인하기 위해 Utf8JsonReader.Read() 한 번의 호출로 진행됩니다.
이 메서드가 완료되면 reader
JSON 값의 최종 토큰에 배치됩니다. 예외가 throw되면 판독기는 메서드가 호출되었을 때의 상태로 다시 설정됩니다.
이 메서드는 판독기가 작업한 데이터의 복사본을 만들므로 이 메서드의 반환 이후에도 데이터 무결성을 유지하기 위한 호출자 요구 사항이 없습니다.
Utf8JsonReader 인스턴스를 만드는 데 사용되는 JsonReaderOptions 충돌할 때 JsonSerializerOptions 우선합니다. 따라서 JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth및 JsonReaderOptions.CommentHandling 읽는 동안 사용됩니다.
자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
단일 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>
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 TValue
표현입니다.
예외
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 값을 역직렬화할 형식입니다.
매개 변수
- options
- JsonSerializerOptions
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
TValue
JSON과 호환되지 않습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
단일 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
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
document
null
.
TValue
JSON과 호환되지 않습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
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>
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 TValue
표현입니다.
예외
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
구현은 기본적으로 UTF-8을 사용하기 때문에 String 사용하는 것이 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
적용 대상
Deserialize<TValue>(String, JsonSerializerOptions)
단일 JSON 값을 나타내는 텍스트를 제네릭 형식 매개 변수로 지정된 형식의 인스턴스로 구문 분석합니다.
public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
형식 매개 변수
- TValue
JSON 값의 대상 형식입니다.
매개 변수
- json
- String
구문 분석할 JSON 텍스트입니다.
- options
- JsonSerializerOptions
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
json
null
.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
구현은 기본적으로 UTF-8을 사용하기 때문에 String 사용하는 것이 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
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
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
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>
변환할 형식에 대한 메타데이터입니다.
반환
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
구문 분석 중 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
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>
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 TValue
표현입니다.
예외
utf8Json
또는 jsonTypeInfo
null
.
JSON이 잘못되었거나, TValue
JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize<TValue>(Stream, JsonSerializerOptions)
단일 JSON 값을 나타내는 UTF-8로 인코딩된 텍스트를 TValue
읽습니다.
스트림은 완료될 때 읽습니다.
public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue
형식 매개 변수
- TValue
JSON 값을 역직렬화할 형식입니다.
매개 변수
- utf8Json
- Stream
구문 분석할 JSON 데이터입니다.
- options
- JsonSerializerOptions
읽는 동안 동작을 제어하는 옵션입니다.
반환
JSON 값의 TValue
표현입니다.
예외
utf8Json
null
.
JSON이 잘못되었거나, TValue
JSON과 호환되지 않거나, Stream에 남아 있는 데이터가 있습니다.
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
적용 대상
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
단일 JSON 값을 나타내는 텍스트를 TValue
구문 분석합니다.
public:
generic <typename TValue>
static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
형식 매개 변수
- TValue
JSON 값을 역직렬화할 형식입니다.
매개 변수
- json
- String
구문 분석할 JSON 텍스트입니다.
- jsonTypeInfo
- JsonTypeInfo<TValue>
변환할 형식에 대한 메타데이터입니다.
반환
JSON 값의 TValue
표현입니다.
예외
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.
설명
구현은 기본적으로 UTF-8을 사용하기 때문에 String 사용하는 것이 UTF-8 메서드를 사용하는 것만큼 효율적이지 않습니다.
적용 대상
.NET