Utf8JsonReader Struktur

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

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

Sumber:

Utf8JsonReader.cs

Menyediakan API berkinerja tinggi untuk akses baca-saja dan hanya-maju ke teks JSON yang dikodekan UTF-8.

public value class Utf8JsonReader

public ref struct Utf8JsonReader

type Utf8JsonReader = struct

Public Structure Utf8JsonReader

Warisan

Object

ValueType

Utf8JsonReader

Keterangan

Utf8JsonReader memproses teks secara berurutan tanpa penembolokan dan secara default mematuhi JSON RFC secara ketat.

Ketika Utf8JsonReader menemukan JSON yang tidak valid, JSON melemparkan JsonException dengan informasi kesalahan dasar seperti nomor baris dan posisi byte pada baris.

Karena jenis ini adalah struct ref, jenis ini tidak secara langsung mendukung asinkron. Namun, ini memberikan dukungan untuk masuk kembali untuk membaca data yang tidak lengkap dan untuk terus membaca setelah lebih banyak data disajikan.

Agar dapat mengatur kedalaman maks saat membaca atau mengizinkan melewatkan komentar, buat instans JsonReaderOptions dan teruskan ke pembaca.

Untuk informasi selengkapnya, lihat Menggunakan Utf8JsonReader.

Konstruktor

Nama	Deskripsi
Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState)	Menginisialisasi instans baru struktur Utf8JsonReader yang memproses urutan baca-saja dari teks yang dikodekan UTF-8 dan menunjukkan apakah input berisi semua teks untuk diproses.
Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions)	Menginisialisasi instans baru struktur Utf8JsonReader yang memproses urutan baca-saja dari teks yang dikodekan UTF-8 menggunakan opsi yang ditentukan.
Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState)	Menginisialisasi instans baru struktur Utf8JsonReader yang memproses rentang baca-saja dari teks yang dikodekan UTF-8 dan menunjukkan apakah input berisi semua teks untuk diproses.
Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions)	Menginisialisasi instans baru struktur Utf8JsonReader yang memproses rentang baca-saja dari teks yang dikodekan UTF-8 menggunakan opsi yang ditentukan.

Properti

Nama	Deskripsi
BytesConsumed	Mendapatkan jumlah total byte yang digunakan sejauh ini oleh instans ini dari Utf8JsonReader.
CurrentDepth	Mendapatkan kedalaman token saat ini.
CurrentState	Mendapatkan status saat ini Utf8JsonReader untuk diteruskan ke konstruktor dengan lebih banyak Utf8JsonReader data.
HasValueSequence	Mendapatkan nilai yang menunjukkan properti mana yang Value akan digunakan untuk mendapatkan nilai token.
IsFinalBlock	Mendapatkan nilai yang menunjukkan apakah semua data JSON disediakan atau ada lebih banyak data yang akan datang.
Position	Mendapatkan saat ini SequencePosition dalam input yang dikodekan UTF-8 yang disediakan readOnlySequence<byte> atau default SequencePosition jika Utf8JsonReader struct dibangun dengan byte> ReadOnlySpan<.
TokenStartIndex	Mendapatkan indeks yang token JSON terakhir diproses dimulai pada (dalam teks input yang dikodekan UTF-8 yang diberikan), melewati spasi kosong apa pun.
TokenType	Mendapatkan jenis token JSON terakhir yang diproses dalam teks JSON yang dikodekan UTF-8.
ValueIsEscaped	Mendapatkan nilai yang menunjukkan apakah properti atau ValueSequence saat ini ValueSpan berisi urutan escape per RFC 8259 bagian 7, dan karenanya memerlukan unescaping sebelum dikonsumsi.
ValueSequence	Mendapatkan nilai mentah dari token terakhir yang diproses sebagai potonong byte> ReadOnlySequence<dari payload input, hanya jika token terkandung dalam beberapa segmen.
ValueSpan	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<.>

Metode

Nama	Deskripsi
CopyString(Span<Byte>)	Menyalin nilai token JSON saat ini dari sumber, tidak dilewati, sebagai byte UTF-8 ke buffer.
CopyString(Span<Char>)	Menyalin nilai token JSON saat ini dari sumber, tidak diescaped, sebagai karakter UTF-16 ke buffer.
GetBoolean()	Membaca nilai token JSON berikutnya dari sumber sebagai Boolean.
GetByte()	Mengurai nilai token JSON saat ini dari sumber sebagai Byte.
GetBytesFromBase64()	Mengurai nilai token JSON saat ini dari sumber dan mendekode string JSON yang dikodekan Base64 sebagai array byte.
GetComment()	Mengurai nilai token JSON saat ini dari sumber sebagai komentar dan mentranskodekannya sebagai String.
GetDateTime()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke DateTime.
GetDateTimeOffset()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke DateTimeOffset.
GetDecimal()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke Decimal.
GetDouble()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke Double.
GetGuid()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke Guid.
GetInt16()	Mengurai nilai token JSON saat ini dari sumber sebagai Int16.
GetInt32()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke Int32.
GetInt64()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke Int64.
GetSByte()	Mengurai nilai token JSON saat ini dari sumber sebagai SByte.
GetSingle()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke Single.
GetString()	Membaca nilai token JSON berikutnya dari sumber yang tidak di-unescaped dan mentranskodekannya sebagai string.
GetUInt16()	Mengurai nilai token JSON saat ini dari sumber sebagai UInt16.
GetUInt32()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke UInt32.
GetUInt64()	Membaca nilai token JSON berikutnya dari sumber dan menguraikannya ke UInt64.
Read()	Membaca token JSON berikutnya dari sumber input.
Skip()	Melompati anak-anak token JSON saat ini.
TryGetByte(Byte)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Byte dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetBytesFromBase64(Byte[])	Mencoba mengurai nilai token JSON saat ini dari sumber dan mendekode string JSON yang dikodekan Base64 sebagai array byte dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetDateTime(DateTime)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai DateTime dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetDateTimeOffset(DateTimeOffset)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai DateTimeOffset dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetDecimal(Decimal)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Decimal dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetDouble(Double)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Double dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetGuid(Guid)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Guid dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetInt16(Int16)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Int16 dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetInt32(Int32)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Int32 dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetInt64(Int64)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Int64 dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetSByte(SByte)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai SByte dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetSingle(Single)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai Single dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetUInt16(UInt16)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai UInt16 dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetUInt32(UInt32)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai UInt32 dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TryGetUInt64(UInt64)	Mencoba mengurai nilai token JSON saat ini dari sumber sebagai UInt64 dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.
TrySkip()	Mencoba melewati anak-anak token JSON saat ini.
ValueTextEquals(ReadOnlySpan<Byte>)	Membandingkan teks yang dikodekan UTF-8 dalam rentang byte baca-saja dengan nilai token JSON yang tidak dilewati di sumber dan mengembalikan nilai yang menunjukkan apakah cocok.
ValueTextEquals(ReadOnlySpan<Char>)	Membandingkan teks dalam rentang karakter baca-saja dengan nilai token JSON yang tidak dilewati di sumber dan mengembalikan nilai yang menunjukkan apakah cocok.
ValueTextEquals(String)	Membandingkan teks string dengan nilai token JSON yang tidak dilewati di sumber dan mengembalikan nilai yang menunjukkan apakah cocok.