Utf8JsonReader.ValueSpan Özellik

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

Paket:

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

Kaynak:

Utf8JsonReader.cs

Belirteç tek bir segmente sığıyorsa veya okuyucu ReadOnlySpan<baytında yer alan bir JSON yüküyle oluşturulduysa, giriş yükünün ReadOnlySpan bayt>> dilimi olarak işlenen son belirtecin<ham değerini alır.

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)

Özellik Değeri

ReadOnlySpan<Byte>

Salt okunur bayt aralığı.

Açıklamalar

JSON bir ReadOnlySequence<baytında> sağlanırsa ve belirteç değerini temsil eden dilim tek bir segmente sığarsa ValueSpan , dilimlenmiş değeri içerir, çünkü bu değer bir span olarak temsil edilebilir. Aksi takdirde, ValueSequence belirteç değerini içerir.

ise HasValueSequencetrueValueSpan boş olur. Bu nedenle, yalnızca ise HasValueSequencefalseerişimValueSpan. Aksi takdirde, belirteç değerine içinden ValueSequenceerişilmelidir.

Bu özelliğin her zaman iyi biçimlendirilmiş veriler içereceğinin garantisi yoktur. 'a Utf8JsonReader geçirilen giriş JSON'u JSON dize belirteçleri içinde geçersiz UTF-8 bayt içeriyorsa, bu özellik bu geçersiz UTF-8 baytlarını olduğu gibi geri döndürür. Bu nedenle, giriş güvenilmezse veya daha önce doğrulanmamışsa JSON dize belirtecini almak için çağrısında GetString() bulunur.

Bu özellik ham baytları döndürdüğünden, metin karşılaştırması için kullanmaktan kaçının. Bunun yerine, gerekirse metnin çıkışını kaldıran öğesini çağırın ValueTextEquals .