Utf8JsonReader.ValueSpan Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar råvärdet för den senast bearbetade token som en ReadOnlySpan<byte-sektor> i indatanyttolasten, om token passar i ett enda segment eller om läsaren har konstruerats med en JSON-nyttolast som finns i en 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)Egenskapsvärde
Ett skrivskyddat intervall med byte.
Kommentarer
Om JSON anges i en ReadOnlySequence-byte<> och den sektor som representerar tokenvärdet passar i ett enda segment, ValueSpan innehåller det segmenterade värdet eftersom det kan representeras som ett spann. Annars ValueSequence innehåller tokenvärdet.
Om HasValueSequence är trueär , ValueSpan är tom.
Därför är det bara åtkomst ValueSpan om HasValueSequence är false.
Annars måste tokenvärdet nås från ValueSequence.
Det finns ingen garanti för att den här egenskapen alltid innehåller välformulerad data. Om indata-JSON som skickades in till Utf8JsonReader innehåller ogiltiga UTF-8 byte i JSON-strängtoken, returnerar den här egenskapen de ogiltiga UTF-8 byte som är.
Om indata inte är betrodda eller inte har verifierats tidigare anropar GetString() du därför för att hämta JSON-strängtoken.
Eftersom den här egenskapen returnerar rå byte bör du undvika att använda den för textjämförelse. Anropa ValueTextEquals i stället vilket som tar bort texten om det behövs.
