Utf8JsonReader.CopyString 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

重载

CopyString(Span<Byte>)	将源中的当前 JSON 令牌值（未转义）作为 UTF-8 字节复制到缓冲区。
CopyString(Span<Char>)	将源中的当前 JSON 令牌值（未转义）作为 UTF-16 字符复制到缓冲区。

CopyString(Span<Byte>)

Source:

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 替代项。

ArgumentException

目标缓冲区太小，无法容纳未转义的值。

注解

与 不同 GetString()，此方法不支持 Null。

如果目标缓冲区太小而无法容纳未转义的值，此方法将引发 ArgumentException 。 可以通过查询 或 ValueSequence的ValueSpan长度来确定适当大小的缓冲区，因为未转义的结果始终小于或等于编码字符串的长度。

另请参阅

• TokenType

CopyString(Span<Char>)

Source:

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 替代项。

ArgumentException

目标缓冲区太小，无法容纳未转义的值。

注解

与 不同 GetString()，此方法不支持 Null。

如果目标缓冲区太小而无法容纳未转义的值，此方法将引发 ArgumentException 。 可以通过查询 或 ValueSequence的ValueSpan长度来确定适当大小的缓冲区，因为未转义的结果始终小于或等于编码字符串的长度。

另请参阅

• TokenType