XamlReader Kelas

Definisi

Ruang nama:

System.Xaml

Rakitan:

System.Xaml.dll

Menyediakan definisi dasar untuk kelas yang menggunakan input XAML dan menghasilkan aliran simpul XAML.

public ref class XamlReader abstract : IDisposable

public abstract class XamlReader : IDisposable

type XamlReader = class
    interface IDisposable

Public MustInherit Class XamlReader
Implements IDisposable

Warisan

Object

XamlReader

Turunan

System.Activities.Debugger.XamlDebuggerXmlReader

System.Windows.Baml2006.Baml2006Reader

System.Xaml.XamlBackgroundReader

System.Xaml.XamlObjectReader

System.Xaml.XamlXmlReader

Penerapan

IDisposable

Keterangan

XamlReader adalah kelas abstrak dan tidak memberikan implementasi atau definisi yang memiliki hasil kerja untuk semua anggota. Anggota yang memiliki implementasi di XamlReader dicatat dalam sambutan untuk anggota tersebut. Secara khusus, XamlReader memiliki beberapa anggota abstrak yang harus diimplementasikan, dan beberapa anggota virtual.

Dari anggota virtual, ReadSubtree dan Skip masing-masing menyediakan implementasi default yang sesuai untuk sebagian besar kasus. Namun, ReadSubtree implementasi dan Skip default mengandalkan perilaku lain yang diharapkan dari pembaca XAML yang mengimplementasikan; khususnya, mereka mengandalkan penimpaan Read . Dispose juga merupakan anggota virtual yang memiliki implementasi default yang berfungsi.

Dua kelas berikut adalah kelas turunan yang paling relevan dan praktis dalam Layanan XAML .NET Framework dan rakitan System.Xaml:

• XamlObjectReader, yang membaca grafik objek, seperti grafik objek aktif aplikasi pada waktu proses.

• XamlXmlReader, yang membaca XAML dalam bentuk file teks XML dengan menggunakan umum XmlReader yang memuat file sebagai kelas pembantu perantara.

Pembaca XAML lainnya dari kerangka kerja lain termasuk Baml2006Reader dan XamlDebuggerXmlReader.

XamlReader berbeda dari XML Document Object Model (DOM) dan XmlReader prinsip desain karena XamlReader tidak memiliki Create metode untuk mengembalikan implementasi pembaca XAML default yang mendasarinya. Anda harus membuat instans kelas pembaca XAML turunan tertentu dengan memanggil konstruktor mereka atau API pembantu khusus kelas lainnya.

Pembaca Subtree

Sebagian besar, Anda memanggil XamlReader API dalam konteks kelas pembaca XAML tertentu yang berasal dari XamlReader. Namun, dalam satu kasus tertentu, Anda mengakses XamlReader API pada instans pembaca XAML praktis yang tidak bersifat publik dan tidak berasal dari XamlObjectReader atau XamlXmlReader. Kasus ini adalah ketika Anda memanggil ReadSubtree, yang mengembalikan instans XamlReader . Dalam implementasi default, XamlReader yang dikembalikan oleh API ini adalah kelas internal.

Yang XamlReader diperoleh untuk pembacaan subtree memiliki tindakan yang valid untuk API seperti Read dan NodeType, dan tindakan tersebut didasarkan pada kelas pembaca induk. Desain ini memungkinkan kelas internal untuk melacak tingkat bingkai tempat subtree dimasukkan. Subtree XamlReader bertindak memastikan bahwa jika posisi simpul saat ini dipindahkan di luar batas subtree, pembaca subtree tertentu melaporkan akhir file atau null pada simpul saat ini.

Catatan tentang penggunaan pembaca subtree disertakan pada API tertentu XamlReader .

Konstruktor

Nama	Deskripsi
XamlReader()	Menginisialisasi XamlReader kelas.

Properti

Nama	Deskripsi
IsDisposed	Mendapat apakah Dispose(Boolean) telah dipanggil.
IsEof	Saat diimplementasikan dalam kelas turunan, mendapatkan nilai yang melaporkan apakah posisi pembaca berada di akhir file.
Member	Ketika diimplementasikan dalam kelas turunan, mendapatkan anggota saat ini pada posisi pembaca, jika posisi pembaca berada di StartMember.
Namespace	Ketika diimplementasikan di kelas turunan, mendapatkan informasi namespace XAML dari simpul saat ini.
NodeType	Ketika diimplementasikan dalam kelas turunan, mendapatkan jenis node saat ini.
SchemaContext	Saat diimplementasikan dalam kelas turunan, mendapatkan objek yang menyediakan informasi konteks skema XAML untuk kumpulan informasi.
Type	Ketika diimplementasikan dalam kelas turunan XamlType , mendapatkan node saat ini.
Value	Ketika diimplementasikan dalam kelas turunan, mendapatkan nilai node saat ini.

Metode

Nama	Deskripsi
Close()	Menutup aliran simpul XAML.
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang digunakan oleh XamlReader, dan secara opsional, merilis sumber daya terkelola.
Read()	Saat diimplementasikan di kelas turunan, berikan simpul XAML berikutnya dari sumbernya, jika simpul tersedia.
ReadSubtree()	Mengembalikan XamlReader yang didasarkan pada saat ini XamlReader, di mana yang dikembalikan XamlReader digunakan untuk melakukan iterasi melalui subtree struktur simpul XAML.
Skip()	Melompati simpul saat ini dan memajukan posisi pembaca ke simpul berikutnya.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IDisposable.Dispose()	Merilis semua sumber daya yang digunakan oleh instans XamlReader kelas saat ini.

Lihat juga

• XamlObjectReader
• XamlXmlReader
• XamlReaderSettings
• Memahami Struktur dan Konsep Aliran Simpul XAML