JsonSerializerOptions.ReferenceHandler Eigenschaft

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Ruft ein Objekt ab oder legt ein Objekt fest, das angibt, wie Objektbezüge beim Lesen und Schreiben von JSON behandelt werden.

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

Eigenschaftswert

ReferenceHandler

Hinweise

Standardmäßig unterstützt die Serialisierung keine Objekte mit Zyklen und behält keine duplizierten Verweise. Metadateneigenschaften werden beim Serialisieren von Referenztypen nicht geschrieben und werden als reguläre Eigenschaften für die Deserialisierung behandelt.

• On Serialize:

  • Behandelt doppelte Objektbezüge, wie wenn sie eindeutig waren und alle ihre Eigenschaften schreiben.
  • Der Serializer löst ein, JsonException wenn ein Objekt einen Zyklus enthält.

• On Deserialize:

  • Metadateneigenschaften ($id, $valuesund ) werden nicht verwendet und $refdaher als reguläre JSON-Eigenschaften behandelt.
  • Die Metadateneigenschaften können einer echten Eigenschaft auf dem JsonExtensionDataAttribute zurückgegebenen Objekt zugeordnet werden, wenn die Eigenschaftennamen übereinstimmen oder dem Überlaufwörterbuch hinzugefügt werden, sofern vorhanden; andernfalls werden sie ignoriert.

Verwenden Sie Preserve die Aktivierung eindeutiger Objektreferenzen für die Serialisierung und den Metadatenverbrauch, um erhaltene Verweise auf die Deerialisierung zu lesen.