Aracılığıyla paylaş


XamlReader Sınıf

Tanım

XAML girişi kullanan ve XAML düğümü akışları üreten sınıflar için temel tanımlar sağlar.

public ref class XamlReader abstract : IDisposable
public abstract class XamlReader : IDisposable
type XamlReader = class
    interface IDisposable
Public MustInherit Class XamlReader
Implements IDisposable
Devralma
XamlReader
Türetilmiş
Uygulamalar

Açıklamalar

XamlReader soyut bir sınıftır ve tüm üyeler için çalışma sonucuna sahip uygulamalar veya tanımlar sağlamaz. içinde XamlReader bir uygulaması olan üyeler, bu üyenin açıklamalarında not edilir. Özellikle, XamlReader uygulanması gereken birkaç soyut üyeye ve birkaç sanal üyeye sahiptir.

Sanal üyeler arasında ve Skip her biri çoğu ReadSubtree durum için uygun bir varsayılan uygulama sağlar. Ancak ve Skip varsayılan uygulamaları, ReadSubtree uygulayan XAML okuyucunun diğer beklenen davranışına dayanır; özellikle geçersiz kılmaya Read güvenir. Dispose ayrıca, çalışan bir varsayılan uygulamaya sahip sanal üyedir.

Aşağıdaki iki sınıf, .NET Framework XAML Hizmetleri ve System.Xaml derlemesindeki en uygun ve pratik türetilmiş sınıflardır:

  • XamlObjectReader, çalışma zamanında uygulamanın etkin nesne grafı gibi bir nesne grafını okur.

  • XamlXmlReader, dosyayı aracı yardımcı sınıfı olarak yükleyen bir genel XmlReader kullanarak XAML'yi XML metin dosyası biçiminde okur.

Diğer çerçevelerden diğer XAML okuyucuları ve XamlDebuggerXmlReaderiçerirBaml2006Reader.

XamlReader XML Belge Nesne Modeli (DOM) ve XmlReader tasarım ilkelerinden farklıdır çünkü XamlReader temel alınan varsayılan XAML okuyucu uygulamalarını döndürmek için bir Create yöntemi yoktur. Bunun yerine, oluşturucularını veya sınıfa özgü diğer yardımcı API'leri çağırarak türetilmiş belirli XAML okuyucu sınıflarının örneğini oluşturmanız gerekir.

Alt Ağaç Okuyucuları

Çoğunlukla, API'yi'nden XamlReadertüretilen belirli XAML okuyucu sınıfları bağlamında çağırırsınızXamlReader. Ancak, belirli bir durumda API'ye genel olmayan ve veya XamlXmlReader'den türetilmeyen pratik bir XAML okuyucu örneğinde XamlObjectReader erişebilirsinizXamlReader. Bu durum, bir XamlReader örnek döndüren çağrısı ReadSubtreeyaptığınızda olur. Varsayılan uygulamada, XamlReader bu API tarafından döndürülen bir iç sınıftır.

XamlReader Alt ağaç okuma için elde edilen, ve NodeTypegibi Read API'ler için geçerli eylemlere sahiptir ve bu eylemler üst okuyucu sınıfını temel alır. Bu tasarım, iç sınıfın alt ağacın girildiği çerçeve düzeyini izlemesini sağlar. Hareket eden alt ağaç XamlReader , geçerli düğüm konumu alt ağacının sınırlarının dışına taşınırsa, belirli alt ağaç okuyucunun dosya sonu veya null geçerli düğümde raporlamasını sağlar.

Alt ağaç okuyucu kullanımıyla ilgili notlar belirli XamlReader API'lere eklenir.

Oluşturucular

XamlReader()

sınıfını XamlReader başlatır.

Özellikler

IsDisposed

Çağrılıp çağrılmadığını Dispose(Boolean) alır.

IsEof

Türetilmiş bir sınıfta uygulandığında, okuyucu konumunun dosya sonunda olup olmadığını bildiren bir değer alır.

Member

Türetilmiş bir sınıfta uygulandığında, okuyucu konumu bir StartMemberüzerindeyse geçerli üyeyi okuyucu konumunda alır.

Namespace

Türetilmiş bir sınıfta uygulandığında, geçerli düğümden XAML ad alanı bilgilerini alır.

NodeType

Türetilmiş bir sınıfta uygulandığında geçerli düğümün türünü alır.

SchemaContext

Türetilmiş bir sınıfta uygulandığında, bilgi kümesi için XAML şema bağlamı bilgilerini sağlayan bir nesne alır.

Type

Türetilmiş bir sınıfta uygulandığında geçerli düğümün öğesini XamlType alır.

Value

Türetilmiş bir sınıfta uygulandığında geçerli düğümün değerini alır.

Yöntemler

Close()

XAML düğümü akışını kapatır.

Dispose(Boolean)

tarafından XamlReaderkullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
Read()

Türetilmiş bir sınıfta uygulandığında, bir düğüm varsa kaynaktan sonraki XAML düğümünü sağlar.

ReadSubtree()

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.

Skip()

Geçerli düğümü atlar ve okuyucu konumunu sonraki düğüme ilerler.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

XamlReader sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.

Şunlara uygulanır

Ayrıca bkz.