Utf8JsonReader Yapı

Tanım

Salt ileri, salt okunurdur UTF-8 kodlu JSON metnine erişim için yüksek performanslı bir API sağlar.Provides a high-performance API for forward-only, read-only access to UTF-8 encoded JSON text.

public value class Utf8JsonReader
public struct Utf8JsonReader
type Utf8JsonReader = struct
Public Structure Utf8JsonReader
Devralma
Utf8JsonReader

Açıklamalar

Utf8JsonReadermetni önbelleğe alma olmadan ve varsayılan olarak JSON RFC'ye bağlı olarak işler.Utf8JsonReader processes the text sequentially with no caching and by default adheres strictly to the JSON RFC.

Utf8JsonReaderGEÇERSIZ JSON ile karşılaştığında, satırdaki JsonException satır numarası ve bayt konumu gibi temel hata bilgilerini içeren bir oluşturur.When Utf8JsonReader encounters invalid JSON, it throws a JsonException with basic error information like line number and byte position on the line.

Bu tür bir başvuru yapısı olduğundan, zaman uyumsuz olarak doğrudan desteklenmez.Since this type is a ref struct, it doesn't directly support async. Ancak, tamamlanmamış verileri okumak ve daha fazla veri sunulduktan sonra okumayı sürdürmek için destek sağlar.However, it does provide support for reentrancy to read incomplete data and to continue reading once more data is presented.

Yorumları okurken veya atlamaya izin verirken en büyük derinliği ayarlayabilmek için bir örneği oluşturun JsonReaderOptions ve bunu okuyucuya geçirin.To be able to set max depth while reading OR allow skipping comments, create an instance of JsonReaderOptions and pass it to the reader.

Daha fazla bilgi için bkz. JSON serileştirme ve seri durumdan çıkarma.For more information, see How to serialize and deserialize JSON.

Oluşturucular

Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState)

Utf8JsonReaderUTF-8 kodlu bir metnin salt okunurdur sırasını işleyen ve girişin işlenecek tüm metni içerip içermediğini belirten yapının yeni bir örneğini başlatır.Initializes a new instance of the Utf8JsonReader structure that processes a read-only sequence of UTF-8 encoded text and indicates whether the input contains all the text to process.

Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions)

Utf8JsonReaderBelirtilen seçenekleri kullanarak UTF-8 kodlu bir metnin salt okunurdur sırasını işleyen yapının yeni bir örneğini başlatır.Initializes a new instance of the Utf8JsonReader structure that processes a read-only sequence of UTF-8 encoded text using the specified options.

Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState)

Utf8JsonReaderUTF-8 kodlu metnin salt okunurdur olan bir yapının yeni bir örneğini başlatır ve girişin işlenecek tüm metni içerip içermediğini belirtir.Initializes a new instance of the Utf8JsonReader structure that processes a read-only span of UTF-8 encoded text and indicates whether the input contains all the text to process.

Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions)

Utf8JsonReaderBelirtilen seçenekleri kullanarak UTF-8 kodlu bir metnin salt okunurdur bir yayılımını işleyen yapının yeni bir örneğini başlatır.Initializes a new instance of the Utf8JsonReader structure that processes a read-only span of UTF-8 encoded text using the specified options.

Özellikler

BytesConsumed

Bu örneği tarafından şimdiye kadar tüketilen toplam bayt sayısını alır Utf8JsonReader .Gets the total number of bytes consumed so far by this instance of the Utf8JsonReader.

CurrentDepth

Geçerli belirtecin derinliğini alır.Gets the depth of the current token.

CurrentState

Utf8JsonReader Utf8JsonReader Daha fazla veri içeren bir oluşturucuya geçirilecek geçerli durumu alır.Gets the current Utf8JsonReader state to pass to a Utf8JsonReader constructor with more data.

HasValueSequence

Belirteç değerini almak için kullanılacak değer özelliğini gösteren bir değer alır.Gets a value that indicates which Value property to use to get the token value.

IsFinalBlock

Utf8JsonReaderTüm JSON verilerinin sağlandığını veya gelmesi gereken daha fazla veri olup olmadığını gösteren bu örneğinin modunu alır.Gets the mode of this instance of the Utf8JsonReader which indicates whether all the JSON data was provided or there is more data to come.

Position

SequencePositionBELIRTILEN UTF-8 kodlu giriş ReadOnlySequence < byte > veya SequencePosition Utf8JsonReader struct bir readonlyspan Byte ile oluşturulduysa varsayılan olarak geçerli bir değer alır < > .Gets the current SequencePosition within the provided UTF-8 encoded input ReadOnlySequence<byte> or a default SequencePosition if the Utf8JsonReader struct was constructed with a ReadOnlySpan<byte>.

TokenStartIndex

Son işlenen JSON belirtecinin başladığı dizini alır (belirtilen UTF-8 kodlu giriş metni içinde) ve herhangi bir boşluk atlanıyor.Gets the index that the last processed JSON token starts at (within the given UTF-8 encoded input text), skipping any white space.

TokenType

UTF-8 kodlu JSON metninde, işlenen son JSON belirtecinin türünü alır.Gets the type of the last processed JSON token in the UTF-8 encoded JSON text.

ValueSequence

Son işlenen belirtecin ham değerini giriş yükünün ReadOnlySequence bayt dilimi olarak alır < > , yalnızca belirteç birden çok kesimde yer alıyorsa.Gets the raw value of the last processed token as a ReadOnlySequence<byte> slice of the input payload, only if the token is contained within multiple segments.

ValueSpan

< > Belirteç tek bir kesimde sığıyorsa veya okuyucu readonlyspan baytında bulunan bir JSON yükünden oluşturulmuşsa, son işlenen belirtecin ham değerini giriş yükünün readonlyspan bayt dilimi olarak alır < > .Gets the raw value of the last processed token as a ReadOnlySpan<byte> slice of the input payload, if the token fits in a single segment or if the reader was constructed with a JSON payload contained in a ReadOnlySpan<byte>.

Yöntemler

GetBoolean()

Kaynaktan bir sonraki JSON belirteci değerini okur Boolean .Reads the next JSON token value from the source as a Boolean.

GetByte()

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırır Byte .Parses the current JSON token value from the source as a Byte.

GetBytesFromBase64()

Kaynaktaki geçerli JSON belirteci değerini ayrıştırır ve Base64 kodlamalı JSON dizesinin kodunu bir bayt dizisi olarak çözer.Parses the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array.

GetComment()

Geçerli JSON belirteci değerini kaynaktan bir açıklama olarak ayrıştırır, bir yorum olarak dönüştürüyorum String .Parses the current JSON token value from the source as a comment, transcoded it as a String.

GetDateTime()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır DateTime .Reads the next JSON token value from the source and parses it to a DateTime.

GetDateTimeOffset()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır DateTimeOffset .Reads the next JSON token value from the source and parses it to a DateTimeOffset.

GetDecimal()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır Decimal .Reads the next JSON token value from the source and parses it to a Decimal.

GetDouble()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır Double .Reads the next JSON token value from the source and parses it to a Double.

GetGuid()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır Guid .Reads the next JSON token value from the source and parses it to a Guid.

GetInt16()

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırır Int16 .Parses the current JSON token value from the source as a Int16.

GetInt32()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır Int32 .Reads the next JSON token value from the source and parses it to an Int32.

GetInt64()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır Int64 .Reads the next JSON token value from the source and parses it to an Int64.

GetSByte()

Geçerli JSON belirteci değerini kaynağından bir olarak ayrıştırır SByte .Parses the current JSON token value from the source as an SByte.

GetSingle()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır Single .Reads the next JSON token value from the source and parses it to a Single.

GetString()

Kaynaktaki bir sonraki JSON belirteci değerini okur, kaçışsız ve dize olarak geri dönüştürülmüş.Reads the next JSON token value from the source, unescaped, and transcoded as a string.

GetUInt16()

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırır UInt16 .Parses the current JSON token value from the source as a UInt16.

GetUInt32()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır UInt32 .Reads the next JSON token value from the source and parses it to a UInt32.

GetUInt64()

Kaynaktaki sonraki JSON belirteci değerini okur ve bir olarak ayrıştırır UInt64 .Reads the next JSON token value from the source and parses it to a UInt64.

Read()

Giriş kaynağından sonraki JSON belirtecini okur.Reads the next JSON token from the input source.

Skip()

Geçerli JSON belirtecinin alt öğelerini atlar.Skips the children of the current JSON token.

TryGetByte(Byte)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Byte ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a Byte and returns a value that indicates whether the operation succeeded.

TryGetBytesFromBase64(Byte[])

Kaynaktaki geçerli JSON belirteci değerini ayrıştırmaya çalışır ve Base64 kodlamalı JSON dizesinin kodunu bir bayt dizisi olarak çözer ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array and returns a value that indicates whether the operation succeeded.

TryGetDateTime(DateTime)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır DateTime ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a DateTime and returns a value that indicates whether the operation succeeded.

TryGetDateTimeOffset(DateTimeOffset)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır DateTimeOffset ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a DateTimeOffset and returns a value that indicates whether the operation succeeded.

TryGetDecimal(Decimal)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Decimal ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a Decimal and returns a value that indicates whether the operation succeeded.

TryGetDouble(Double)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Double ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a Double and returns a value that indicates whether the operation succeeded.

TryGetGuid(Guid)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Guid ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a Guid and returns a value that indicates whether the operation succeeded.

TryGetInt16(Int16)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Int16 ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as an Int16 and returns a value that indicates whether the operation succeeded.

TryGetInt32(Int32)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Int32 ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as an Int32 and returns a value that indicates whether the operation succeeded.

TryGetInt64(Int64)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Int64 ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as an Int64 and returns a value that indicates whether the operation succeeded.

TryGetSByte(SByte)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır SByte ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as an SByte and returns a value that indicates whether the operation succeeded.

TryGetSingle(Single)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır Single ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a Single and returns a value that indicates whether the operation succeeded.

TryGetUInt16(UInt16)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır UInt16 ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a UInt16 and returns a value that indicates whether the operation succeeded.

TryGetUInt32(UInt32)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır UInt32 ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a UInt32 and returns a value that indicates whether the operation succeeded.

TryGetUInt64(UInt64)

Geçerli JSON belirteci değerini kaynaktan bir olarak ayrıştırmaya çalışır UInt64 ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.Tries to parse the current JSON token value from the source as a UInt64 and returns a value that indicates whether the operation succeeded.

TrySkip()

Geçerli JSON belirtecinin alt öğelerini atlamaya çalışır.Tries to skip the children of the current JSON token.

ValueTextEquals(ReadOnlySpan<Byte>)

Salt okunabilir bir bayt aralığında bulunan UTF-8 kodlu metni kaynaktaki kaçışsız JSON belirteci değeriyle karşılaştırır ve eşleşip eşleşmediğini belirten bir değer döndürür.Compares the UTF-8 encoded text in a read-only byte span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

ValueTextEquals(ReadOnlySpan<Char>)

Salt okunurdur bir karakter alanındaki metni kaynak içindeki kaçışsız JSON belirteci değeriyle karşılaştırır ve eşleşip eşleşmeyeceğini belirten bir değer döndürür.Compares the text in a read-only character span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

ValueTextEquals(String)

Dize metnini kaynaktaki kaçışsız JSON belirteci değeriyle karşılaştırır ve eşleşip eşleşmediğini gösteren bir değer döndürür.Compares the string text to the unescaped JSON token value in the source and returns a value that indicates whether they match.

Şunlara uygulanır