Aracılığıyla paylaş

XamlReader Sınıf

Tanım

Ad Alanı:
System.Xaml
Bütünleştirilmiş Kod:
System.Xaml.dll

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
Object
XamlReader
Türetilmiş
Uygulamalar
IDisposable

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 uygulaması olan üyeler, bu üyenin açıklamalarında not edilir. Özellikle, XamlReader uygulanması gereken birkaç soyut üyeye ve birkaç sanal üyeye sahiptir.

Sanal üyeler ReadSubtree arasında ve Skip her biri çoğu durumda uygun bir varsayılan uygulama sağlar. Ancak ve Skip varsayılan uygulamaları, ReadSubtree uygulayan XAML okuyucunun beklenen diğer davranışına dayanır; özellikle de geçersiz kılmayı Read kullanır. Dispose aynı zamanda çalışan varsayılan uygulaması olan bir sanal üyedir.

Aşağıdaki iki sınıf, .NET Framework XAML Hizmetleri ve System.Xaml derlemesindeki en ilgili 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çevelerdeki diğer XAML okuyucuları ve XamlDebuggerXmlReaderdeğerlerini iç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 belirli türetilmiş XAML okuyucu sınıflarının örneğini oluşturmanız gerekir.

Alt Ağaç Okuyucuları

Çoğunlukla API'yi' den 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şilirXamlReader. Bu durum, bir XamlReader örnek döndüren öğesini çağırdığınızda ReadSubtreeolur. 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 konumunun alt ağacının sınırlarının dışına taşınması durumunda, belirli alt ağaç okuyucusunun 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

Name Description
XamlReader()

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

Özellikler

Name Description
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 bilgileri sağlayan bir nesne alır.
Type

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

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

Yöntemler

Name Description
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()

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

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

Geçerli Objectbasit 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ı üzerinden yinelemek için döndürülen XamlReader geçerli değerini 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 bir dize döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name Description
IDisposable.Dispose()

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

Şunlara uygulanır

Ayrıca bkz.