JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Yöntem

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

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);

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

Okuması gereken 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 oluştuğuna neden olur.

Özel durumlar

ArgumentException

reader desteklenmeyen seçenekler içerir.

-veya-

Geçerli reader belirteç başlatılmaz veya bir değeri temsil etmez.

JsonException

Okuyucudan bir değer okunamadı.

Açıklamalar

TokenType özelliği reader veya JsonTokenType.NoneiseJsonTokenType.PropertyName, okuyucu değerin başlangıcını belirlemek için öğesine Utf8JsonReader.Read() bir ç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.