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

Значение свойства

ReferenceHandler

Комментарии

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

  • При сериализации:

    • Обрабатывает повторяющиеся ссылки на объекты, как если бы они были уникальными и записывали все их свойства.
    • Сериализатор создает исключение, JsonException если объект содержит цикл.
  • При десериализации:

    • Свойства метаданных ($id, $valuesи $ref) не будут использоваться и поэтому будут рассматриваться как обычные свойства JSON.
    • Свойства метаданных могут сопоставляться с реальным свойством возвращаемого объекта, если имена свойств совпадают или будут добавлены в JsonExtensionDataAttribute словарь переполнения, если таковой существует; в противном случае они игнорируются.

Используется Preserve для включения сохранения уникальных ссылок на объекты при сериализации и потреблении метаданных для чтения сохраненных ссылок на десериализацию.

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