JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Yöntem

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

Paket:

System.Text.Json v11.0.0-preview.5.26302.115

Kaynak:

JsonDocument.Parse.cs

Sağlanan okuyucudan bir JSON değerini (nesneler veya diziler dahil) ayrıştırmaya çalışır.

public:
 static bool TryParseValue(System::Text::Json::Utf8JsonReader % reader, [Runtime::InteropServices::Out] System::Text::Json::JsonDocument ^ % document);

public static bool TryParseValue(ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonDocument? document);

static member TryParseValue : Utf8JsonReader * JsonDocument -> bool

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef document As JsonDocument) As Boolean

Parametreler

reader

Utf8JsonReader

Okunacak okuyucu.

document

JsonDocument

Yöntemi döndürdüğünde ayrıştırılmış belgeyi içerir.

Döndürülenler

Boolean

true bir değer okunduysa ve JsonDocument olarak ayrıştırıldıysa; false okuyucunun ayrıştırma sırasında verisi tükendiyse. Diğer tüm durumlar bir özel durumun atılmasıyla sonuçlanır.

Özel durumlar

ArgumentException

reader desteklenmeyen seçenekler içerir.

-veya-

Geçerli reader belirteç bir değeri başlatmıyor veya temsil etmiyor.

JsonException

Okuyucudan bir değer okunamadı.

Açıklamalar

TokenType veya özelliği JsonTokenType.NonereaderJsonTokenType.PropertyName ise, okuyucu değerin başlangıcını belirlemek için bir Utf8JsonReader.Read() çağrı ile ilerler.

Bu yöntem tamamlandıktan sonra, reader JSON değerindeki son belirteçte konumlandırılır. Bir özel durum oluşturulursa veya false döndürülürse, okuyucu yöntem çağrıldığında olduğu duruma sıfırlanır.

Bu yöntem okuyucunun üzerinde işlem yaptığı verilerin bir kopyasını oluşturur, bu nedenle bu yöntemin döndürülmesinin ötesinde veri bütünlüğünü korumak için çağıran gereksinimi yoktur.