JsonSerializerOptions.ReferenceHandler Propriedade

Definição

Obtém ou define um objeto que especifica como as referências de objetos são tratadas ao ler e escrever 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

Valor de Propriedade

Observações

Por defeito, a serialização não suporta objetos com ciclos e não preserva referências duplicadas. As propriedades dos metadados não serão escritas ao serializar tipos de referência e serão tratadas como propriedades regulares na desserialização.

  • Sobre Serializar:

    • Trata as referências duplicadas de objetos como se fossem únicas e escreve todas as suas propriedades.
    • O serializador lança um JsonException se um objeto contém um ciclo.
  • Sobre Deserializar:

    • As propriedades dos metadados ($id, $values, e $ref) não serão consumidas e, por isso, serão tratadas como propriedades JSON normais.
    • As propriedades dos metadados podem mapear para uma propriedade real no objeto devolvido se os nomes das propriedades coincidirem, ou serão adicionadas ao JsonExtensionDataAttribute dicionário de overflow, caso exista um; caso contrário, são ignoradas.

Use Preserve para permitir a preservação de referências únicas de objetos na serialização e consumo de metadados para ler referências preservadas na desserialização.

Aplica-se a