JsonSerializerOptions.ReferenceHandler Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Objekts, das angibt, wie Objektverweise 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

Hinweise

Standardmäßig unterstützt die Serialisierung keine Objekte mit Zyklen und behält keine doppelten Verweise bei. Metadateneigenschaften werden beim Serialisieren von Verweistypen nicht geschrieben und als normale Eigenschaften für die Deserialisierung behandelt.

  • Beim Serialisieren:

    • Behandelt doppelte Objektverweise so, als wären sie eindeutig und schreiben alle ihre Eigenschaften.
    • Der Serialisierer löst ein JsonException , wenn ein Objekt einen Zyklus enthält.
  • On Deserialize:

    • Metadateneigenschaften ($id, $valuesund $ref) werden nicht verwendet und daher als normale JSON-Eigenschaften behandelt.
    • Die Metadateneigenschaften können einer echten Eigenschaft für das zurückgegebene Objekt zugeordnet werden, wenn die Eigenschaftennamen übereinstimmen oder dem JsonExtensionDataAttribute Überlaufwörterbuch hinzugefügt werden, sofern vorhanden. Andernfalls werden sie ignoriert.

Wird verwendet Preserve , um die Erhaltung eindeutiger Objektverweise für serialisierung und Metadatennutzung zu ermöglichen, um beibehaltene Verweise auf die Deserialisierung zu lesen.

Gilt für: