JsonSerializerOptions.ReferenceHandler Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.
- As propriedades dos metadados (
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.