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