JsonSerializerOptions.ReferenceHandler Properti

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

System.Text.Json v11.0.0-preview.5.26302.115

Sumber:

JsonSerializerOptions.cs

Mendapatkan atau mengatur objek yang menentukan bagaimana referensi objek ditangani saat membaca dan menulis 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

Nilai Properti

ReferenceHandler

Keterangan

Secara default, serialisasi tidak mendukung objek dengan siklus dan tidak mempertahankan referensi duplikat. Properti metadata tidak akan ditulis ketika menserialisasikan jenis referensi dan akan diperlakukan sebagai properti reguler saat deserialisasi.

• Pada Serialisasi:

  • Memperlakukan referensi objek duplikat seolah-olah mereka unik dan menulis semua propertinya.
  • Serializer melempar JsonException jika objek berisi siklus.

• Saat Deserialisasi:

  • Properti metadata ($id, $values, dan $ref) tidak akan dikonsumsi dan oleh karena itu akan diperlakukan sebagai properti JSON reguler.
  • Properti metadata dapat memetakan ke properti nyata pada objek yang dikembalikan jika nama properti cocok, atau akan ditambahkan ke JsonExtensionDataAttribute kamus luapan, jika ada; jika tidak, mereka diabaikan.

Gunakan Preserve untuk mengaktifkan pelestarian referensi objek unik pada serialisasi dan konsumsi metadata untuk membaca referensi yang dipertahankan pada deserialisasi.