Sdílet prostřednictvím

XamlReader Třída

  • Reference

Definice

Obor názvů:
System.Xaml
Sestavení:
System.Xaml.dll

Poskytuje základní definice tříd, které využívají vstup XAML a vytvářejí streamy uzlů XAML.

public ref class XamlReader abstract : IDisposable
public abstract class XamlReader : IDisposable
type XamlReader = class
    interface IDisposable
Public MustInherit Class XamlReader
Implements IDisposable
Dědičnost
Object
XamlReader
Odvozené
Implementuje
IDisposable

Poznámky

XamlReader je abstraktní třída a neposkytuje implementace ani definice, které mají funkční výsledek pro všechny členy. Členové, kteří mají implementaci, XamlReader jsou uvedeni v poznámkách pro daného člena. XamlReader Konkrétně má několik abstraktních členů, které je potřeba implementovat, a několik virtuálních členů.

U virtuálních členů ReadSubtree a Skip každá z nich poskytuje výchozí implementaci, která je vhodná pro většinu případů. ReadSubtree Výchozí implementace Skip ale spoléhají na jiné očekávané chování implementační čtečky XAML, zejména na přepsáníRead. Dispose je také virtuální člen, který má funkční výchozí implementaci.

Následující dvě třídy jsou nejrelevavantnější a praktické odvozené třídy v .NET Framework služeb XAML a sestavení System.Xaml:

  • XamlObjectReader, který čte graf objektů, například aktivní objektový graf aplikace za běhu.

  • XamlXmlReader, který čte XAML ve formě textového souboru XML pomocí obecného XmlReader , který načte soubor jako pomocné třídy zprostředkujícího pomocníka.

Mezi další čtenáře XAML z jiných architektur patří Baml2006Reader a XamlDebuggerXmlReader.

XamlReader liší se od principů modelu DOM (Document Object Model) a XmlReader návrhu XML, protože XamlReader nemá metodu Create pro vrácení základních výchozích implementací čtečky XAML. Místo toho je nutné vytvořit instanci konkrétních odvozených tříd čtenáře XAML voláním jejich konstruktorů nebo jiných pomocných rozhraní API specifických pro třídu.

Čtečky podstromů

Ve většině případů voláte XamlReader rozhraní API v kontextu konkrétních tříd čtenáře XAML odvozených z XamlReader. V jednom konkrétním případě ale přistupujete k XamlReader rozhraní API v praktické instanci čtenáře XAML, která není veřejná a není odvozena z XamlObjectReader nebo XamlXmlReader. Tento případ je při volání ReadSubtree, který vrátí XamlReader instanci. Ve výchozí implementaci XamlReader je vrácená tímto rozhraním API interní třída.

Získané XamlReader pro čtení podstromů má platné akce pro rozhraní API, jako Read jsou a NodeTypea tyto akce jsou založeny na nadřazené třídě čtenáře. Tento návrh umožňuje interní třídě sledovat úroveň rámce, ve které byl podstrom zadán. Podřízený podstrom zajišťuje, že pokud je aktuální pozice uzlu přesunuta nad hranicemi podstromu, konkrétní čtečka podstromů XamlReader hlásí konec souboru nebo null aktuální uzel.

Poznámky k využití čtečky podstromů jsou součástí určitých XamlReader rozhraní API.

Konstruktory

XamlReader()

Inicializuje XamlReader třídu.

Vlastnosti

IsDisposed

Získá, jestli Dispose(Boolean) byl volána.
IsEof

Při implementaci v odvozené třídě získá hodnotu, která hlásí, zda je pozice čtenáře na konci souboru.
Member

Při implementaci v odvozené třídě získá aktuální člen na pozici čtenáře, pokud je pozice čtenáře na StartMember.
Namespace

Při implementaci v odvozené třídě získá informace o oboru názvů XAML z aktuálního uzlu.
NodeType

Při implementaci v odvozené třídě získá typ aktuálního uzlu.
SchemaContext

Při implementaci v odvozené třídě získá objekt, který poskytuje informace o kontextu schématu XAML pro sadu informací.
Type

Při implementaci v odvozené třídě získá XamlType aktuální uzel.
Value

Při implementaci v odvozené třídě získá hodnotu aktuálního uzlu.

Metody

Close()

Zavře stream uzlu XAML.
Dispose(Boolean)

Uvolní nespravované prostředky používané XamlReadernástrojem a volitelně uvolní spravované prostředky.
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
Read()

Při implementaci v odvozené třídě poskytuje další uzel XAML ze zdroje, pokud je uzel k dispozici.
ReadSubtree()

XamlReader Vrátí hodnotu založenou na aktuálním XamlReader, kde vrácená XamlReader hodnota slouží k iteraci podstrom struktury uzlu XAML.
Skip()

Přeskočí aktuální uzel a přejde na pozici čtenáře na další uzel.
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

IDisposable.Dispose()

Uvolní všechny prostředky používané aktuální instancí XamlReader třídy.

Platí pro

Viz také