JsonSerializerOptions 클래스

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

패키지:

System.Text.Json v11.0.0-preview.4.26230.115

Source:

JsonSerializerOptions.cs

와 함께 JsonSerializer사용할 옵션을 제공합니다.

public ref class JsonSerializerOptions sealed

public sealed class JsonSerializerOptions

type JsonSerializerOptions = class

Public NotInheritable Class JsonSerializerOptions

상속

Object

JsonSerializerOptions

설명

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

생성자

Name	Description
JsonSerializerOptions()	JsonSerializerOptions 클래스의 새 인스턴스를 초기화합니다.
JsonSerializerOptions(JsonSerializerDefaults)	지정된 옵션에 의해 결정되는 미리 정의된 옵션 집합을 사용하여 새 JsonSerializerOptions 인스턴스를 생성합니다 JsonSerializerDefaults.
JsonSerializerOptions(JsonSerializerOptions)	인스턴스에서 새 인스턴스로 JsonSerializerOptions 옵션을 복사합니다.

속성

Name	Description
AllowDuplicateProperties	JSON 개체를 역직렬화할 때 중복 속성 이름이 허용되는지 여부를 나타내는 값을 가져오거나 설정합니다.
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	이 경우 사용할 WriteIndentedtrue새 줄 문자열을 가져오거나 설정합니다. 기본값은 NewLine 값입니다.
NumberHandling	serialize 또는 역직렬화할 때 숫자 형식을 처리하는 방법을 지정하는 개체를 가져오거나 설정합니다.
PreferredObjectCreationHandling	JSON을 역직렬화할 때 속성에 대한 기본 개체 만들기 처리를 가져오거나 설정합니다.
PropertyNameCaseInsensitive	역직렬화하는 동안 속성 이름이 대/소문자를 구분하지 않는 비교를 사용하는지 여부를 나타내는 값을 가져오거나 설정합니다. 기본값은 false입니다.
PropertyNamingPolicy	개체의 속성 이름을 camel-casing과 같은 다른 형식으로 변환하거나 속성 이름을 변경하지 않은 상태로 두는 데 사용되는 정책을 지정하는 값을 가져오거나 null 설정합니다.
ReadCommentHandling	역직렬화 중에 주석이 처리되는 방식을 정의하는 값을 가져오거나 설정합니다.
ReferenceHandler	JSON을 읽고 쓸 때 개체 참조를 처리하는 방법을 지정하는 개체를 가져오거나 설정합니다.
RespectNullableAnnotations	serialization 및 deserialization 중에 null 허용 여부 주석을 적용해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
RespectRequiredConstructorParameters	역직렬화하는 동안 선택적이 아닌 생성자 매개 변수를 지정해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
Strict	엄격한 구성을 사용하는 읽기 전용 싱글톤 인스턴스 JsonSerializerOptions 를 가져옵니다.
TypeInfoResolver	이 인스턴스에서 JsonTypeInfo 사용하는 계약 확인자를 가져오거나 설정합니다.
TypeInfoResolverChain	이 인스턴스에서 사용하는 연결된 JsonTypeInfo 계약 확인자 목록을 가져옵니다.
UnknownTypeHandling	역직렬화 중에 선언된 형식을 역직렬화하는 방법을 지정하는 개체를 Object 가져오거나 설정합니다.
UnmappedMemberHandling	개체 형식을 역직렬화할 때 JsonSerializer 특정 .NET 멤버에 매핑할 수 없는 JSON 속성을 처리하는 방법을 지정하는 개체를 가져오거나 설정합니다.
Web	웹 구성을 사용하는 읽기 전용 싱글톤 인스턴스 JsonSerializerOptions 를 가져옵니다.
WriteIndented	JSON에서 인쇄를 사용해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. 기본적으로 JSON은 추가 공백 없이 직렬화됩니다.

메서드

Name	Description
AddContext<TContext>()	사용되지 않음. 현재 JsonSerializerOptions 인스턴스의 메타데이터 확인에 새 JsonSerializerContext 항목이 추가됩니다.
GetConverter(Type)	지정된 형식의 변환기를 반환합니다.
GetTypeInfo(Type)	현재 JsonSerializerOptions 인스턴스에서 JsonTypeInfo 확인된 계약 메타데이터를 가져옵니다.
GetTypeInfo<T>()	와 함께 JsonSerializer사용할 옵션을 제공합니다.
MakeReadOnly()	현재 인스턴스를 읽기 전용으로 표시하여 추가 사용자 수정을 방지합니다.
MakeReadOnly(Boolean)	현재 인스턴스를 읽기 전용으로 표시하여 추가 사용자 수정을 방지합니다.
TryGetTypeInfo(Type, JsonTypeInfo)	현재 JsonSerializerOptions 인스턴스에서 JsonTypeInfo 확인된 계약 메타데이터를 가져오려고 시도합니다.
TryGetTypeInfo<T>(JsonTypeInfo<T>)	와 함께 JsonSerializer사용할 옵션을 제공합니다.

확장명 메서드

Name	Description
AddAIContentType(JsonSerializerOptions, Type, String)	에 대한 다형 구성에 사용자 지정 콘텐츠 형식을 추가합니다 AIContent.
AddAIContentType<TContent>(JsonSerializerOptions, String)	에 대한 다형 구성에 사용자 지정 콘텐츠 형식을 추가합니다 AIContent.
GetJsonSchemaAsNode(JsonSerializerOptions, Type, JsonSchemaExporterOptions)	지정된 형식의 계약 메타데이터에 해당하는 JSON 스키마를 생성합니다.