Utf8JsonReader.CopyString Méthode

Définition

Espace de noms:

System.Text.Json

Assembly:

System.Text.Json.dll

Surcharges

CopyString(Span<Byte>)	Copie la valeur actuelle du jeton JSON de la source, non échiffée, en tant qu’octets UTF-8 dans une mémoire tampon.
CopyString(Span<Char>)	Copie la valeur actuelle du jeton JSON de la source, non boucée, sous forme de caractères UTF-16 dans une mémoire tampon.

CopyString(Span<Byte>)

Source:

Utf8JsonReader.TryGet.cs

Copie la valeur actuelle du jeton JSON de la source, non échiffée, en tant qu’octets UTF-8 dans une mémoire tampon.

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

Paramètres

utf8Destination

Span<Byte>

Mémoire tampon dans laquelle écrire les octets UTF-8 non échiffés.

Retours

Int32

Nombre d’octets écrits dans utf8Destination.

Exceptions

InvalidOperationException

Le jeton JSON n’est pas une chaîne, c’est-à-dire qu’il n’est pas String ou PropertyName.

- ou -

La chaîne JSON contient des octets UTF-8 non valides ou des substituts UTF-16 non valides.

ArgumentException

La mémoire tampon de destination est trop petite pour contenir la valeur non échiffée.

Remarques

Contrairement à GetString(), cette méthode ne prend pas en charge Null.

Cette méthode lève un ArgumentException si la mémoire tampon de destination est trop petite pour contenir la valeur non échiffée. Vous pouvez déterminer une mémoire tampon de taille appropriée en consultant la longueur de ValueSpan ou ValueSequence, car le résultat non échiffé est toujours inférieur ou égal à la longueur des chaînes encodées.

Voir aussi

• TokenType

CopyString(Span<Char>)

Source:

Utf8JsonReader.TryGet.cs

Copie la valeur actuelle du jeton JSON de la source, non boucée, sous forme de caractères UTF-16 dans une mémoire tampon.

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

Paramètres

destination

Span<Char>

Mémoire tampon dans laquelle écrire les caractères UTF-16 transcodés.

Retours

Int32

Nombre de caractères écrits dans destination.

Exceptions

InvalidOperationException

Le jeton JSON n’est pas une chaîne, c’est-à-dire qu’il n’est pas String ou PropertyName.

- ou -

La chaîne JSON contient des octets UTF-8 non valides ou des substituts UTF-16 non valides.

ArgumentException

La mémoire tampon de destination est trop petite pour contenir la valeur non échiffée.

Remarques

Contrairement à GetString(), cette méthode ne prend pas en charge Null.

Cette méthode lève un ArgumentException si la mémoire tampon de destination est trop petite pour contenir la valeur non échiffée. Vous pouvez déterminer une mémoire tampon de taille appropriée en consultant la longueur de ValueSpan ou ValueSequence, car le résultat non échiffé est toujours inférieur ou égal à la longueur des chaînes encodées.

Voir aussi

• TokenType