Utf8JsonReader.CopyString Metoda

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Balíček:

System.Text.Json v11.0.0-preview.4.26230.115

Přetížení

Name	Description
CopyString(Span<Byte>)	Zkopíruje aktuální hodnotu tokenu JSON ze zdroje, která není neurčitá, jako bajty UTF-8 do vyrovnávací paměti.
CopyString(Span<Char>)	Zkopíruje aktuální hodnotu tokenu JSON ze zdroje bez neurčení jako UTF-16 znaků do vyrovnávací paměti.

CopyString(Span<Byte>)

Zdroj:

Utf8JsonReader.TryGet.cs

Zkopíruje aktuální hodnotu tokenu JSON ze zdroje, která není neurčitá, jako bajty UTF-8 do vyrovnávací paměti.

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>

Vyrovnávací paměť pro zápis unescaped UTF-8 bajtů do.

Návraty

Int32

Počet bajtů zapsaných do utf8Destination.

Výjimky

InvalidOperationException

Token JSON není řetězec, to znamená, že není String nebo PropertyName.

nebo

Řetězec JSON obsahuje neplatné bajty UTF-8 nebo neplatné náhradní znaky UTF-16.

ArgumentException

Cílová vyrovnávací paměť je příliš malá, aby neudržovala neuskutečené hodnoty.

Poznámky

Na rozdíl od GetString(), tato metoda nepodporuje Null.

Tato metoda vyvolá ArgumentException výjimku, pokud je cílová vyrovnávací paměť příliš malá, aby byla uložena unescaped hodnota. Vyrovnávací paměť s odpovídající velikostí můžete určit po konzultaci s délkou buď ValueSpan nebo ValueSequence, protože unescaped výsledek je vždy menší nebo roven délce zakódovaných řetězců.

Viz také

• TokenType

CopyString(Span<Char>)

Zdroj:

Utf8JsonReader.TryGet.cs

Zkopíruje aktuální hodnotu tokenu JSON ze zdroje bez neurčení jako UTF-16 znaků do vyrovnávací paměti.

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>

Vyrovnávací paměť pro zápis transkódovaných znaků UTF-16 do.

Návraty

Int32

Počet znaků zapsaných do destination.

Výjimky

InvalidOperationException

Token JSON není řetězec, to znamená, že není String nebo PropertyName.

nebo

Řetězec JSON obsahuje neplatné bajty UTF-8 nebo neplatné náhradní znaky UTF-16.

ArgumentException

Cílová vyrovnávací paměť je příliš malá, aby neudržovala neuskutečené hodnoty.

Poznámky

Na rozdíl od GetString(), tato metoda nepodporuje Null.

Tato metoda vyvolá ArgumentException výjimku, pokud je cílová vyrovnávací paměť příliš malá, aby byla uložena unescaped hodnota. Vyrovnávací paměť s odpovídající velikostí můžete určit po konzultaci s délkou buď ValueSpan nebo ValueSequence, protože unescaped výsledek je vždy menší nebo roven délce zakódovaných řetězců.

Viz také

• TokenType