JsonSerializerOptions.ReferenceHandler Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um objeto que especifica como as referências de objeto são tratadas ao ler e gravar 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 da propriedade
Comentários
Por padrão, a serialização não dá suporte a objetos com ciclos e não preserva referências duplicadas. As propriedades de metadados não serão gravadas ao serializar tipos de referência e serão tratadas como propriedades regulares na desserialização.
Em Serializar:
- Trata referências de objeto duplicadas como se fossem exclusivas e grava todas as suas propriedades.
- O serializador lança um JsonException se um objeto contiver um ciclo.
Ao desserializar:
- As propriedades de metadados (
$ide$ref$values) não serão consumidas e, portanto, serão tratadas como propriedades JSON regulares. - As propriedades de metadados podem ser mapeadas para uma propriedade real no objeto retornado se os nomes de propriedade corresponderem ou serão adicionados ao JsonExtensionDataAttribute dicionário de estouro, se houver; caso contrário, eles serão ignorados.
- As propriedades de metadados (
Use Preserve para habilitar a preservação de referência de objeto exclusiva na serialização e no consumo de metadados para ler referências preservadas na desserialização.