XamlReader.ReadSubtree Yöntem

Tanım

Ad Alanı:

System.Xaml

Bütünleştirilmiş Kod:

System.Xaml.dll

XamlReader XAML düğüm yapısının XamlReaderbir alt ağacı aracılığıyla yinelemek için döndürülen XamlReader geçerli öğesini temel alan bir döndürür.

public:
 virtual System::Xaml::XamlReader ^ ReadSubtree();

public virtual System.Xaml.XamlReader ReadSubtree ();

abstract member ReadSubtree : unit -> System.Xaml.XamlReader
override this.ReadSubtree : unit -> System.Xaml.XamlReader

Public Overridable Function ReadSubtree () As XamlReader

Döndürülenler

XamlReader

Alt ağaç için yeni bir XAML okuyucu örneği.

Açıklamalar

Bu yöntem varsayılan bir uygulamaya sahiptir ve geçerli XamlReaderbir döndürür. Döndürülen XamlReader , belirli XamlReader eylemleri kısıtlayan bir iç sınıftır. Kısıtlamalar, XAML düğüm kümesi için daha büyük bir kaynağın yalnızca boyutlanmış alt ağacını okuma ve alt ağaç çıkıldığında dosya sonu veya null geçerli düğümde döndürme amacıyla tutarlıdır.

Genellikle, alt ağaç okuyucuya ihtiyacınız olup olmadığını belirlemek için başlangıçtaki Read geçerli düğümü denetlemeniz gerekir. Bunu denetleme yönteminiz uygulamaya özgü olabilir; ancak, her alt ağaç için birden çok alt ağaç okuyucu oluşturmaktan kaçının. Ayrıca, düğüm alt ağacı içeremeyen belirli düğüm durumları (örneğin, için) için NamespaceDeclarationbir alt ağaç okuyucu çağırmaktan kaçının.

Bir alt ağaç okuyucu elde ettikten sonra, geçerli bir düğüm elde etmek için (veya bir sonraki düğümü almak için çağrısı yapmak için) onu çağırmanız Skip gerekirRead. Alt ağaç okuyucudan ilk düğüm konumunu oluşturduğunuzda otomatik olarak alılmaz.

Bu varsayılan uygulamadan çağırarak ReadSubtree elde ettiğiniz okuyucu bir iç sınıftır. İç sınıf, davranışını XamlReader çağrıldığında ReadSubtree kullanılan uygulamaya dayandırıyor. İç sınıfın amacı ve genel dolaşma davranışını sarmalamadır Read . Çiftleri veya StartObject/EndObject çiftleri izleyerek StartMember/EndMember dolaşma hedeflenen alt ağaç içinde kalır. Ayrıca, okuyucu giriş noktası tarafından tanımlandığı gibi alt ağacının sonunda olduğunda ve Read true için IsEof de doğru bir şekilde döndürürfalse. Genel olarak, alt ağaç okuyucudan çağırdığınız herhangi XamlReader bir API'nin çapraz geçiş sınırlayıcı davranış dışında genelle XamlReader aynı uygulamaya sahip olduğunu varsayarsınız.

Ancak sanaldır ReadSubtree . Bu nedenle, belirli XamlReader bir uygulama iç sarmalayıcı davranışından XamlReader farklı bir davranış sağlayabilir ve bir XamlReader uygulama döndürerek NotImplementedException alt ağaç okuyucu işlevselliğini veya diğer özel durumları devre dışı bırakabilir.