JsonSerializerOptions.ReferenceHandler Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
- Metadateneigenschaften (
Wird verwendet Preserve , um die Erhaltung eindeutiger Objektverweise für serialisierung und Metadatennutzung zu ermöglichen, um beibehaltene Verweise auf die Deserialisierung zu lesen.