Utf8JsonReader.CopyString メソッド

定義

名前空間:

System.Text.Json

アセンブリ:

System.Text.Json.dll

オーバーロード

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 トークンは文字列ではありません。つまり、 または PropertyNameではありませんString。

- または -

JSON 文字列に無効な UTF-8 バイトまたは無効な UTF-16 サロゲートが含まれています。

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 トークンは文字列ではありません。つまり、 または PropertyNameではありませんString。

- または -

JSON 文字列に無効な UTF-8 バイトまたは無効な UTF-16 サロゲートが含まれています。

ArgumentException

宛先バッファーが小さすぎて、エスケープされていない値を保持できません。

注釈

とは異なり GetString()、このメソッドは をサポート Nullしていません。

このメソッドは、宛先バッファーが小さすぎてエスケープされていない値を保持しない場合に をスロー ArgumentException します。 エスケープされていない結果は常にエンコードされた文字列の長さ以下であるため、 または ValueSequenceのいずれかのValueSpan長さを調べて、適切なサイズのバッファーを決定できます。

こちらもご覧ください

• TokenType