Compartir a través de


JsonSerializerOptions.ReferenceHandler Propiedad

Definición

Obtiene o establece un objeto que especifica cómo se controlan las referencias de objeto al leer y escribir 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 propiedad

Comentarios

De forma predeterminada, la serialización no admite objetos con ciclos y no conserva referencias duplicadas. Las propiedades de metadatos no se escribirán al serializar los tipos de referencia y se tratarán como propiedades normales en la deserialización.

  • Al serializar:

    • Trata las referencias de objeto duplicadas como si fueran únicas y escriben todas sus propiedades.
    • El serializador produce un JsonException si un objeto contiene un ciclo.
  • En Deserializar:

    • Las propiedades de metadatos ($id, $valuesy $ref) no se consumirán y, por tanto, se tratarán como propiedades JSON normales.
    • Las propiedades de metadatos se pueden asignar a una propiedad real en el objeto devuelto si coinciden los nombres de propiedad o se agregarán al JsonExtensionDataAttribute diccionario de desbordamiento, si existe alguna; de lo contrario, se omiten.

Use para habilitar la conservación de referencias Preserve de objetos única en la serialización y el consumo de metadatos para leer referencias conservadas en la deserialización.

Se aplica a