JsonSerializerOptions.ReferenceHandler Propiedad

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Paquete:

System.Text.Json v9.0.0-rc.2.24473.5

Source:

JsonSerializerOptions.cs

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

ReferenceHandler

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.