Utf8JsonReader.ValueSpan 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 potongan byte ReadOnlySpan<dari payload input, jika token cocok dalam satu segmen atau jika pembaca dibangun dengan payload JSON yang terkandung dalam byte> ReadOnlySpan<.>

public:
 property ReadOnlySpan<System::Byte> ValueSpan { ReadOnlySpan<System::Byte> get(); };

public ReadOnlySpan<byte> ValueSpan { get; }

member this.ValueSpan : ReadOnlySpan<byte>

Public ReadOnly Property ValueSpan As ReadOnlySpan(Of Byte)

Nilai Properti

ReadOnlySpan<Byte>

Rentang byte baca-saja.

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 true, ValueSpan kosong. Oleh karena itu, hanya akses ValueSpan jika HasValueSequence adalah false. Jika tidak, nilai token harus diakses dari ValueSequence.

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 teks yang tidak di-unescapes jika perlu.