JsonSerializerOptions.ReferenceHandler Propriedade

Definição

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.

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.

Aplica-se a