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ı üzerinden yinelemek için döndürülen XamlReader geçerli değerini 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öntemin varsayılan bir uygulaması vardır 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 yalnızca daha büyük bir kaynağın 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 ilk Read düğümdeki 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 bunu çağırmanız Read (veya bir sonraki düğümü almak için çağırmanız Skip ) gerekir. Alt ağaç okuyucudan ilk düğüm konumunu oluşturduğunuzda otomatik olarak elde edilmez.

Bu varsayılan uygulamadan çağırarak ReadSubtree aldığınız okuyucu bir iç sınıftır. İç sınıf, davranışını çağrıldığında ReadSubtree kullanılan uygulamaya dayandırıyorXamlReader. İç 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, giriş noktası tarafından tanımlandığı gibi, okuyucu alt ağacının sonunda olduğunda ve IsEoftrue için doğru bir şekilde döndürür falseRead. Genel olarak, alt ağaç okuyucudan çağırdığınız herhangi XamlReader bir API'nin, dolaşma sınırlayıcı davranışı dışında genel XamlReader uygulamayla 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 veya diğer özel durumlar döndürerek NotImplementedException alt ağaç okuyucu işlevselliğini devre dışı bırakabilir.