共用方式為


Utf8JsonReader.CopyString 方法

定義

多載

CopyString(Span<Byte>)

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

CopyString(Span<Char>)

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

CopyString(Span<Byte>)

來源:
Utf8JsonReader.TryGet.cs
來源:
Utf8JsonReader.TryGet.cs
來源:
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 位元組的緩衝區。

傳回

寫入至 utf8Destination 的位元組數。

例外狀況

JSON 權杖不是字串,也就是不是 StringPropertyName

-或-

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

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

備註

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

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

另請參閱

適用於

CopyString(Span<Char>)

來源:
Utf8JsonReader.TryGet.cs
來源:
Utf8JsonReader.TryGet.cs
來源:
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 字元的緩衝區。

傳回

寫入 的 destination 字元數。

例外狀況

JSON 權杖不是字串,也就是不是 StringPropertyName

-或-

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

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

備註

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

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

另請參閱

適用於