Utf8JsonReader.ValueSequence Properti

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

System.Text.Json v11.0.0-rc.1.26425.128

Sumber:

Utf8JsonReader.cs

Mendapatkan nilai mentah dari token terakhir yang diproses sebagai potonong byte> ReadOnlySequence<dari payload input, hanya jika token terkandung dalam beberapa segmen.

public:
 property System::Buffers::ReadOnlySequence<System::Byte> ValueSequence { System::Buffers::ReadOnlySequence<System::Byte> get(); };

public System.Buffers.ReadOnlySequence<byte> ValueSequence { get; }

member this.ValueSequence : System.Buffers.ReadOnlySequence<byte>

Public ReadOnly Property ValueSequence As ReadOnlySequence(Of Byte)

Nilai Properti

ReadOnlySequence<Byte>

Urutan baca-saja byte.

Keterangan

Jika JSON disediakan dalam byte> ReadOnlySequence<dan irisan yang mewakili nilai token cocok dalam satu segmen, maka ValueSpan berisi nilai irisan karena dapat direpresentasikan sebagai rentang. Jika tidak, ValueSequence berisi nilai token.

Jika HasValueSequence adalah false, ValueSequence kosong. Oleh karena itu, hanya akses ValueSequence jika HasValueSequence adalah true. Jika tidak, nilai token harus diakses dari ValueSpan.

Tidak ada jaminan bahwa properti ini akan selalu berisi data yang terbentuk dengan baik. Jika input JSON yang diteruskan ke Utf8JsonReader berisi byte UTF-8 yang tidak valid dalam token string JSON, properti ini akan mengembalikan byte UTF-8 yang tidak valid apa adanya. Oleh karena itu, jika input tidak tepercaya atau tidak divalidasi sebelumnya, panggil GetString() untuk mendapatkan token string JSON.

Karena properti ini mengembalikan byte mentah, hindari menggunakannya untuk perbandingan teks. Sebagai gantinya, panggil ValueTextEquals, yang membuka teks jika perlu.