Utf8JsonReader.ValueSpan Propriété

Définition

Espace de noms:

System.Text.Json

Assembly:

System.Text.Json.dll

Obtient la valeur brute du dernier jeton traité en tant que section ReadOnlySpan<byte> de la charge utile d’entrée, si le jeton entre dans un seul segment ou si le lecteur a été construit avec une charge utile JSON contenue dans un ReadOnlySpan<byte>.

public:
 property ReadOnlySpan<System::Byte> ValueSpan { ReadOnlySpan<System::Byte> get(); };

public ReadOnlySpan<byte> ValueSpan { get; }

member this.ValueSpan : ReadOnlySpan<byte>

Public ReadOnly Property ValueSpan As ReadOnlySpan(Of Byte)

Valeur de propriété

ReadOnlySpan<Byte>

Étendue d’octets en lecture seule.

Remarques

Si le texte JSON est fourni dans une ReadOnlySequence<byte> et que la section qui représente la valeur du jeton rentre dans un seul segment, ValueSpan contient la valeur sectionnée dans la mesure où il peut être représenté comme étendue. Sinon, la ValueSequence contient la valeur du jeton.

Si HasValueSequence c’est truele cas, ValueSpan est vide. Par conséquent, seul l’accès ValueSpan est HasValueSequence false. Sinon, la valeur du jeton doit être accessible à partir de ValueSequence.

Il n’existe aucune garantie que cette propriété contiendra toujours des données bien formées. Si le JSON d’entrée transmis aux Utf8JsonReader octets UTF-8 non valides dans les jetons de chaîne JSON, cette propriété retourne ces octets UTF-8 non valides comme c’est le cas. Par conséquent, si l’entrée n’est pas approuvée ou non validée précédemment, appelez GetString() pour obtenir le jeton de chaîne JSON.

Étant donné que cette propriété retourne les octets bruts, évitez de l’utiliser pour la comparaison de texte. Au lieu de cela, appelez ValueTextEquals ce qui supprime le texte si nécessaire.