Utf8JsonReader.CopyString 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

套件:

System.Text.Json v9.0.0-preview.3.24172.9

多載

CopyString(Span<Byte>)	將目前 JSON 權杖值從來源未逸出，當做 UTF-8 位元組複製到緩衝區。
CopyString(Span<Char>)	將目前的 JSON 權杖值從來源未逸出，當做 UTF-16 字元複製到緩衝區。

CopyString(Span<Byte>)

來源:

Utf8JsonReader.TryGet.cs

將目前 JSON 權杖值從來源未逸出，當做 UTF-8 位元組複製到緩衝區。

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

參數

utf8Destination

Span<Byte>

要寫入未逸出 UTF-8 位元組的緩衝區。

傳回

Int32

寫入至 utf8Destination 的位元組數。

例外狀況

InvalidOperationException

JSON 權杖不是字串，也就是不是 String 或 PropertyName 。

-或-

JSON 字串包含無效 UTF-8 位元組或無效 UTF-16 Surrogate。

ArgumentException

目的地緩衝區太小，無法保存未逸出的值。

備註

不同于 GetString() ，這個方法不支援 Null 。

如果目的地緩衝區太小而無法保存未逸出的值，這個方法將會擲 ArgumentException 回 。 您可以藉由諮詢 或 ValueSequence 的 ValueSpan 長度來判斷適當大小的緩衝區，因為未逸出的結果一律小於或等於編碼字串的長度。

另請參閱

• TokenType

CopyString(Span<Char>)

來源:

Utf8JsonReader.TryGet.cs

將目前的 JSON 權杖值從來源未逸出，當做 UTF-16 字元複製到緩衝區。

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

參數

destination

Span<Char>

要寫入轉碼 UTF-16 字元的緩衝區。

傳回

Int32

寫入 的 destination 字元數。

例外狀況

InvalidOperationException

JSON 權杖不是字串，也就是不是 String 或 PropertyName 。

-或-

JSON 字串包含無效 UTF-8 位元組或無效 UTF-16 Surrogate。

ArgumentException

目的地緩衝區太小，無法保存未逸出的值。

備註

不同于 GetString() ，這個方法不支援 Null 。

如果目的地緩衝區太小而無法保存未逸出的值，這個方法將會擲 ArgumentException 回 。 您可以藉由諮詢 或 ValueSequence 的 ValueSpan 長度來判斷適當大小的緩衝區，因為未逸出的結果一律小於或等於編碼字串的長度。

另請參閱

• TokenType