다음을 통해 공유


JsonSerializerOptions 클래스

정의

JsonSerializer사용할 수 있는 옵션을 제공합니다.

public ref class JsonSerializerOptions sealed
public sealed class JsonSerializerOptions
type JsonSerializerOptions = class
Public NotInheritable Class JsonSerializerOptions
상속
JsonSerializerOptions

설명

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

생성자

JsonSerializerOptions()

JsonSerializerOptions 클래스의 새 인스턴스를 초기화합니다.

JsonSerializerOptions(JsonSerializerDefaults)

지정된 JsonSerializerDefaults의해 결정되는 미리 정의된 옵션 집합을 사용하여 새 JsonSerializerOptions 인스턴스를 생성합니다.

JsonSerializerOptions(JsonSerializerOptions)

JsonSerializerOptions 인스턴스에서 새 인스턴스로 옵션을 복사합니다.

속성

AllowOutOfOrderMetadataProperties

역직렬화된 JSON 개체의 일반 속성 다음에 JSON 메타데이터 속성을 지정할 수 있습니다.

AllowTrailingCommas

개체 또는 배열의 JSON 값 목록 끝에 있는 추가 쉼표가 역직렬화되는 JSON 페이로드 내에서 허용(및 무시)되는지 여부를 나타내는 값을 얻거나 설정합니다.

Converters

등록된 사용자 정의 변환기 목록을 가져옵니다.

Default

기본 구성을 사용하는 JsonSerializerOptions 읽기 전용 싱글톤 인스턴스를 가져옵니다.

DefaultBufferSize

임시 버퍼를 만들 때 사용할 기본 버퍼 크기(바이트)를 가져오거나 설정합니다.

DefaultIgnoreCondition

serialization 또는 deserialization 중에 기본값이 있는 속성이 무시되는 시기를 결정하는 값을 가져오거나 설정합니다. 기본값은 Never.

DictionaryKeyPolicy

IDictionary 키의 이름을 카멜 대/소문자 같은 다른 형식으로 변환하는 데 사용되는 정책을 가져오거나 설정합니다.

Encoder

문자열을 이스케이프할 때 사용할 인코더를 가져오거나 설정하거나 기본 인코더를 사용할 null.

IgnoreNullValues
사용되지 않음.

serialization 및 deserialization 중에 null 값이 무시되는지 여부를 나타내는 값을 가져오거나 설정합니다. 기본값은 false.

IgnoreReadOnlyFields

serialization 중에 읽기 전용 필드가 무시되는지 여부를 나타내는 값을 가져오거나 설정합니다. 필드가 readonly 키워드로 표시된 경우 읽기 전용입니다. 기본값은 false.

IgnoreReadOnlyProperties

serialization 중에 읽기 전용 속성이 무시되는지 여부를 나타내는 값을 가져옵니다. 기본값은 false.

IncludeFields

serialization 및 deserialization 중에 필드가 처리되는지 여부를 나타내는 값을 가져오거나 설정합니다. 기본값은 false.

IndentCharacter

WriteIndented 사용할 때 사용되는 들여쓰기 문자를 정의합니다. 기본값은 공백 문자입니다.

IndentSize

WriteIndented 사용할 때 사용되는 들여쓰기 크기를 정의합니다. 기본값은 2입니다.

IsReadOnly

현재 인스턴스가 사용자 수정을 위해 잠겨 있는지 여부를 나타내는 값을 가져옵니다.

MaxDepth

JSON을 직렬화하거나 역직렬화할 때 허용되는 최대 깊이를 가져오거나 설정하며, 기본값은 0으로 최대 깊이는 64입니다.

NewLine

WriteIndented true때 사용할 새 줄 문자열을 가져오거나 설정합니다.

기본값은 NewLine값입니다.

NumberHandling

serialize 또는 역직렬화할 때 숫자 형식을 처리하는 방법을 지정하는 개체를 가져오거나 설정합니다.

PreferredObjectCreationHandling

JSON을 역직렬화할 때 속성에 대한 기본 개체 만들기 처리를 가져오거나 설정합니다.

PropertyNameCaseInsensitive

역직렬화하는 동안 속성 이름이 대/소문자를 구분하지 않는 비교를 사용하는지 여부를 나타내는 값을 가져오거나 설정합니다. 기본값은 false.

PropertyNamingPolicy

개체의 속성 이름을 낙타 대/소문자 같은 다른 형식으로 변환하거나 속성 이름을 변경하지 않는 null 변환하는 데 사용되는 정책을 지정하는 값을 가져오거나 설정합니다.

ReadCommentHandling

역직렬화 중에 주석이 처리되는 방식을 정의하는 값을 가져오거나 설정합니다.

ReferenceHandler

JSON을 읽고 쓸 때 개체 참조를 처리하는 방법을 지정하는 개체를 가져오거나 설정합니다.

RespectNullableAnnotations

serialization 및 deserialization 중에 null 허용 여부 주석을 적용해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

RespectRequiredConstructorParameters

역직렬화하는 동안 선택적이 아닌 생성자 매개 변수를 지정해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

TypeInfoResolver

이 인스턴스에서 사용하는 JsonTypeInfo 계약 확인자를 가져오거나 설정합니다.

TypeInfoResolverChain

이 인스턴스에서 사용하는 연결된 JsonTypeInfo 계약 확인자 목록을 가져옵니다.

UnknownTypeHandling

역직렬화하는 동안 Object 선언된 형식을 역직렬화하는 방법을 지정하는 개체를 가져오거나 설정합니다.

UnmappedMemberHandling

개체 형식을 역직렬화할 때 특정 .NET 멤버에 매핑할 수 없는 JSON 속성을 JsonSerializer 처리하는 방법을 지정하는 개체를 가져오거나 설정합니다.

Web

웹 구성을 사용하는 JsonSerializerOptions 읽기 전용 싱글톤 인스턴스를 가져옵니다.

WriteIndented

JSON에서 인쇄를 사용해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. 기본적으로 JSON은 추가 공백 없이 직렬화됩니다.

메서드

AddContext<TContext>()
사용되지 않음.

현재 JsonSerializerOptions 인스턴스의 메타데이터 확인에 새 JsonSerializerContext 추가합니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
GetConverter(Type)

지정된 형식의 변환기를 반환합니다.

GetHashCode()

기본 해시 함수로 사용됩니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
GetTypeInfo(Type)

현재 JsonSerializerOptions 인스턴스에서 확인된 JsonTypeInfo 계약 메타데이터를 가져옵니다.

MakeReadOnly()

현재 인스턴스를 읽기 전용으로 표시하여 추가 사용자 수정을 방지합니다.

MakeReadOnly(Boolean)

현재 인스턴스를 읽기 전용으로 표시하여 추가 사용자 수정을 방지합니다.

MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)
TryGetTypeInfo(Type, JsonTypeInfo)

현재 JsonSerializerOptions 인스턴스에서 JsonTypeInfo 계약 메타데이터를 확인하려고 시도합니다.

확장 메서드

GetJsonSchemaAsNode(JsonSerializerOptions, Type, JsonSchemaExporterOptions)

JsonNode 문서로 type JSON 스키마를 가져옵니다.

적용 대상