Utf8JsonReader.CopyString Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Pakiet:

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

Przeciążenia

CopyString(Span<Byte>)	Kopiuje bieżącą wartość tokenu JSON ze źródła, unescaped, jako bajty UTF-8 do buforu.
CopyString(Span<Char>)	Kopiuje bieżącą wartość tokenu JSON ze źródła, unescaped, jako znaki UTF-16 do buforu.

CopyString(Span<Byte>)

Źródło:

Utf8JsonReader.TryGet.cs

Kopiuje bieżącą wartość tokenu JSON ze źródła, unescaped, jako bajty UTF-8 do buforu.

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

Parametry

utf8Destination

Span<Byte>

Bufor do zapisu niezauważonych bajtów UTF-8.

Zwraca

Int32

Liczba bajtów zapisanych w pliku utf8Destination.

Wyjątki

InvalidOperationException

Token JSON nie jest ciągiem, czyli nie String jest to ani PropertyName.

-lub-

Ciąg JSON zawiera nieprawidłowe bajty UTF-8 lub nieprawidłowe zastępcy UTF-16.

ArgumentException

Bufor docelowy jest za mały, aby przechowywać niezaużytą wartość.

Uwagi

W przeciwieństwie do GetString()metody ta metoda nie obsługuje metody Null.

Ta metoda zgłosi błąd ArgumentException , jeśli bufor docelowy jest zbyt mały, aby pomieścić niezasłaną wartość. Bufor o odpowiednim rozmiarze można określić, konsultując długość ValueSpan ciągu lub ValueSequence, ponieważ wynik unescaped jest zawsze mniejszy lub równy długości zakodowanych ciągów.

Zobacz też

• TokenType

CopyString(Span<Char>)

Źródło:

Utf8JsonReader.TryGet.cs

Kopiuje bieżącą wartość tokenu JSON ze źródła, unescaped, jako znaki UTF-16 do buforu.

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

Parametry

destination

Span<Char>

Bufor do zapisania transkodowanych znaków UTF-16.

Zwraca

Int32

Liczba znaków zapisanych w pliku destination.

Wyjątki

InvalidOperationException

Token JSON nie jest ciągiem, czyli nie String jest to ani PropertyName.

-lub-

Ciąg JSON zawiera nieprawidłowe bajty UTF-8 lub nieprawidłowe zastępcy UTF-16.

ArgumentException

Bufor docelowy jest za mały, aby przechowywać niezaużytą wartość.

Uwagi

W przeciwieństwie do GetString()metody ta metoda nie obsługuje metody Null.

Ta metoda zgłosi błąd ArgumentException , jeśli bufor docelowy jest zbyt mały, aby pomieścić niezasłaną wartość. Bufor o odpowiednim rozmiarze można określić, konsultując długość ValueSpan ciągu lub ValueSequence, ponieważ wynik unescaped jest zawsze mniejszy lub równy długości zakodowanych ciągów.

Zobacz też

• TokenType