JsonSerializerOptions Класс

Определение

Предоставляет параметры для использования с JsonSerializer.

public ref class JsonSerializerOptions sealed
public sealed class JsonSerializerOptions
type JsonSerializerOptions = class
Public NotInheritable Class JsonSerializerOptions
Наследование
JsonSerializerOptions

Комментарии

Дополнительные сведения см. в статье "Сериализация и десериализация JSON".

Конструкторы

Имя Описание
JsonSerializerOptions()

Инициализирует новый экземпляр класса JsonSerializerOptions.

JsonSerializerOptions(JsonSerializerDefaults)

Создает новый JsonSerializerOptions экземпляр с предопределенным набором параметров, определенных указанным JsonSerializerDefaults.

JsonSerializerOptions(JsonSerializerOptions)

Копирует параметры из экземпляра JsonSerializerOptions в новый экземпляр.

Свойства

Имя Описание
AllowDuplicateProperties

Возвращает или задает значение, указывающее, разрешены ли повторяющиеся имена свойств при десериализации объектов JSON.

AllowOutOfOrderMetadataProperties

Возвращает или задает значение, указывающее, можно ли указывать свойства метаданных JSON после регулярных свойств в десериализированном объекте JSON.

AllowTrailingCommas

Получает или задает значение, указывающее, разрешено ли дополнительное запятое в конце списка значений JSON в объекте или массиве (и игнорируется) в полезных данных JSON, десериализированных.

Converters

Возвращает список определяемых пользователем преобразователей, зарегистрированных.

Default

Получает только для чтения одноэлементный экземпляр JsonSerializerOptions , использующий конфигурацию по умолчанию.

DefaultBufferSize

Возвращает или задает размер буфера по умолчанию в байтах, используемый при создании временных буферов.

DefaultIgnoreCondition

Возвращает или задает значение, определяющее, когда свойства со значениями по умолчанию игнорируются во время сериализации или десериализации. Значение по умолчанию — Never.

DictionaryKeyPolicy

Возвращает или задает политику, используемую для преобразования IDictionary имени ключа в другой формат, например верблюдьего регистра.

Encoder

Возвращает или задает кодировщик для использования при экранировании строк или null для использования кодировщика по умолчанию.

IgnoreNullValues
Устаревшие..

Возвращает или задает значение, указывающее, игнорируются ли null значения во время сериализации и десериализации. Значение по умолчанию — false.

IgnoreReadOnlyFields

Возвращает или задает значение, указывающее, игнорируются ли поля только для чтения во время сериализации. Поле доступно только для чтения, если оно отмечено ключевым словом readonly . Значение по умолчанию — false.

IgnoreReadOnlyProperties

Возвращает или задает значение, указывающее, игнорируются ли свойства только для чтения во время сериализации. Значение по умолчанию — false.

IncludeFields

Возвращает или задает значение, указывающее, обрабатываются ли поля во время сериализации и десериализации. Значение по умолчанию — false.

IndentCharacter

Определяет символ отступа, используемый при WriteIndented включении. По умолчанию используется символ пробела.

IndentSize

Определяет размер отступа, используемый при WriteIndented включении. По умолчанию — два.

IsReadOnly

Возвращает значение, указывающее, заблокирован ли текущий экземпляр для изменения пользователя.

MaxDepth

Возвращает или задает максимальную глубину, разрешенную при сериализации или десериализации JSON, со значением по умолчанию 0, указывающее максимальную глубину 64.

NewLine

Возвращает или задает новую строку строки, которая будет использоваться при WriteIndented использовании true.

Значение по умолчанию — это значение NewLine.

NumberHandling

Возвращает или задает объект, указывающий, как следует обрабатывать типы чисел при сериализации или десериализации.

PreferredObjectCreationHandling

Возвращает или задает предпочтительную обработку создания объектов для свойств при десериализации JSON.

PropertyNameCaseInsensitive

Возвращает или задает значение, указывающее, используется ли имя свойства без учета регистра во время десериализации. Значение по умолчанию — false.

PropertyNamingPolicy

Получает или задает значение, указывающее политику, используемую для преобразования имени свойства в объект в другой формат, например верблюдьего регистра, или null оставлять имена свойств неизменными.

ReadCommentHandling

Возвращает или задает значение, определяющее способ обработки комментариев во время десериализации.

ReferenceHandler

Возвращает или задает объект, указывающий способ обработки ссылок на объекты при чтении и записи JSON.

RespectNullableAnnotations

Возвращает или задает значение, указывающее, следует ли учитывать заметки null во время сериализации и десериализации.

RespectRequiredConstructorParameters

Возвращает или задает значение, указывающее, следует ли указывать не необязательные параметры конструктора во время десериализации.

Strict

Получает только для чтения одноэлементный экземпляр JsonSerializerOptions , использующий строгую конфигурацию.

TypeInfoResolver

Возвращает или задает сопоставитель контракта, используемый этим экземпляром JsonTypeInfo .

TypeInfoResolverChain

Возвращает список сопоставителей контрактов в цепочке JsonTypeInfo , используемых этим экземпляром.

UnknownTypeHandling

Возвращает или задает объект, указывающий способ десериализации типа, объявленного как Object десериализация во время десериализации.

UnmappedMemberHandling

Возвращает или задает объект, указывающий, как JsonSerializer обрабатывает свойства JSON, которые невозможно сопоставить с определенным элементом .NET при десериализации типов объектов.

Web

Получает только для чтения одноэлементный экземпляр JsonSerializerOptions , использующий веб-конфигурацию.

WriteIndented

Возвращает или задает значение, указывающее, следует ли использовать довольно печать JSON. По умолчанию JSON сериализуется без дополнительного пробела.

Методы

Имя Описание
AddContext<TContext>()
Устаревшие..

Добавляет новый JsonSerializerContext к разрешению метаданных текущего JsonSerializerOptions экземпляра.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetConverter(Type)

Возвращает преобразователь для указанного типа.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
GetTypeInfo(Type)

Возвращает метаданные контракта, JsonTypeInfo разрешенные текущим JsonSerializerOptions экземпляром.

GetTypeInfo<T>()

Предоставляет параметры для использования с JsonSerializer.

MakeReadOnly()

Помечает текущий экземпляр как доступный только для чтения, чтобы предотвратить дальнейшее изменение пользователя.

MakeReadOnly(Boolean)

Помечает текущий экземпляр как доступный только для чтения, чтобы предотвратить дальнейшее изменение пользователя.

MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
TryGetTypeInfo(Type, JsonTypeInfo)

Пытается получить метаданные JsonTypeInfo контракта, разрешенные текущим JsonSerializerOptions экземпляром.

TryGetTypeInfo<T>(JsonTypeInfo<T>)

Предоставляет параметры для использования с JsonSerializer.

Методы расширения

Имя Описание
AddAIContentType(JsonSerializerOptions, Type, String)

Добавляет пользовательский тип контента в полиморфную конфигурацию.AIContent

AddAIContentType<TContent>(JsonSerializerOptions, String)

Добавляет пользовательский тип контента в полиморфную конфигурацию.AIContent

GetJsonSchemaAsNode(JsonSerializerOptions, Type, JsonSchemaExporterOptions)

Создает схему JSON, соответствующую метаданным контракта указанного типа.

Применяется к