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, setPublic Property ReferenceHandler As ReferenceHandlerValor 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 gera um JsonException se um objeto contiver um ciclo.
Ao desserializar:
- As propriedades de metadados (
$id``$valuese$ref) 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, caso contrário, eles serão ignorados.
- As propriedades de metadados (
Use Preserve para habilitar a preservação de referência de objeto exclusiva no consumo de serialização e metadados para ler referências preservadas sobre desserialização.