Utf8JsonReader.CopyString Metode

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

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

Overload

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.

CopyString(Span<Byte>)

Sumber:

Utf8JsonReader.TryGet.cs

Menyalin nilai token JSON saat ini dari sumber, tidak dilewati, sebagai byte UTF-8 ke buffer.

public:
 int CopyString(Span<System::Byte> utf8Destination);

public readonly int CopyString(Span<byte> utf8Destination);

member this.CopyString : Span<byte> -> int

Public Function CopyString (utf8Destination As Span(Of Byte)) As Integer

Parameter

utf8Destination

Span<Byte>

Buffer untuk menulis byte UTF-8 yang tidak disetujui.

Mengembalikan

Int32

Jumlah byte yang ditulis ke utf8Destination.

Pengecualian

InvalidOperationException

Token JSON bukan string, yaitu bukan String atau PropertyName.

-atau-

String JSON berisi pengganti UTF-8 yang tidak valid atau UTF-16 yang tidak valid.

ArgumentException

Buffer tujuan terlalu kecil untuk menahan nilai yang tidak dilewati.

Keterangan

Tidak seperti GetString(), metode ini tidak mendukung Null.

Metode ini akan melemparkan ArgumentException jika buffer tujuan terlalu kecil untuk menahan nilai yang tidak dilewati. Anda dapat menentukan buffer berukuran tepat dengan berkonsultasi panjang atau ValueSpanValueSequence, karena hasil yang tidak dilewati selalu kurang dari atau sama dengan panjang string yang dikodekan.

Lihat juga

• TokenType

CopyString(Span<Char>)

Sumber:

Utf8JsonReader.TryGet.cs

Menyalin nilai token JSON saat ini dari sumber, tidak diescaped, sebagai karakter UTF-16 ke buffer.

public:
 int CopyString(Span<char> destination);

public readonly int CopyString(Span<char> destination);

member this.CopyString : Span<char> -> int

Public Function CopyString (destination As Span(Of Char)) As Integer

Parameter

destination

Span<Char>

Buffer untuk menulis karakter UTF-16 yang ditranskodekan.

Mengembalikan

Int32

Jumlah karakter yang ditulis ke destination.

Pengecualian

InvalidOperationException

Token JSON bukan string, yaitu bukan String atau PropertyName.

-atau-

String JSON berisi pengganti UTF-8 yang tidak valid atau UTF-16 yang tidak valid.

ArgumentException

Buffer tujuan terlalu kecil untuk menahan nilai yang tidak dilewati.

Keterangan

Tidak seperti GetString(), metode ini tidak mendukung Null.

Metode ini akan melemparkan ArgumentException jika buffer tujuan terlalu kecil untuk menahan nilai yang tidak dilewati. Anda dapat menentukan buffer berukuran tepat dengan berkonsultasi panjang atau ValueSpanValueSequence, karena hasil yang tidak dilewati selalu kurang dari atau sama dengan panjang string yang dikodekan.

Lihat juga

• TokenType