JsonSerializerOptions.ReferenceHandler Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает объект, указывающий способ обработки ссылок на объекты при чтении и записи JSON.
public:
property System::Text::Json::Serialization::ReferenceHandler ^ ReferenceHandler { System::Text::Json::Serialization::ReferenceHandler ^ get(); void set(System::Text::Json::Serialization::ReferenceHandler ^ value); };
public System.Text.Json.Serialization.ReferenceHandler? ReferenceHandler { get; set; }
member this.ReferenceHandler : System.Text.Json.Serialization.ReferenceHandler with get, set
Public Property ReferenceHandler As ReferenceHandler
Значение свойства
Комментарии
По умолчанию сериализация не поддерживает объекты с циклами и не сохраняет повторяющиеся ссылки. Свойства метаданных не будут записываться при сериализации ссылочных типов и будут рассматриваться как обычные свойства при десериализации.
При сериализации:
- Обрабатывает повторяющиеся ссылки на объекты, как если бы они были уникальными и записывали все их свойства.
- Сериализатор создает исключение, JsonException если объект содержит цикл.
При десериализации:
- Свойства метаданных (
$id
,$values
и$ref
) не будут использоваться и поэтому будут рассматриваться как обычные свойства JSON. - Свойства метаданных могут сопоставляться с реальным свойством возвращаемого объекта, если имена свойств совпадают или будут добавлены в JsonExtensionDataAttribute словарь переполнения, если таковой существует; в противном случае они игнорируются.
- Свойства метаданных (
Используется Preserve для включения сохранения уникальных ссылок на объекты при сериализации и потреблении метаданных для чтения сохраненных ссылок на десериализацию.