JsonSerializerOptions.ReferenceHandler Propriedade

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

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

ReferenceHandler

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.

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.