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.

ArgumentException

Целевой буфер слишком мал, чтобы вместить неэкранированное значение.

Комментарии

В отличие от GetString(), этот метод не поддерживает Null.

Этот метод вызывает исключение , ArgumentException если целевой буфер слишком мал для хранения неэкранированного значения. Вы можете определить буфер соответствующего размера, проконсультировавшись с длиной ValueSpan или ValueSequence, так как неэкранированный результат всегда меньше или равен длине закодированных строк.

См. также раздел

• 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.

ArgumentException

Целевой буфер слишком мал, чтобы вместить неэкранированное значение.

Комментарии

В отличие от GetString(), этот метод не поддерживает Null.

Этот метод вызывает исключение , ArgumentException если целевой буфер слишком мал для хранения неэкранированного значения. Вы можете определить буфер соответствующего размера, проконсультировавшись с длиной ValueSpan или ValueSequence, так как неэкранированный результат всегда меньше или равен длине закодированных строк.

См. также раздел

• TokenType