XamlReader Klass

Definition

Namnområde:
System.Xaml
Sammansättning:
System.Xaml.dll

Tillhandahåller basdefinitioner för klasser som använder XAML-indata och producerar XAML-nodströmmar.

public ref class XamlReader abstract : IDisposable
public abstract class XamlReader : IDisposable
type XamlReader = class
    interface IDisposable
Public MustInherit Class XamlReader
Implements IDisposable
Arv
Object
XamlReader
Härledda
Implementeringar
IDisposable

Kommentarer

XamlReader är en abstrakt klass och tillhandahåller inte implementeringar eller definitioner som har ett fungerande resultat för alla medlemmar. Medlemmar som har en implementering i XamlReader noteras i kommentarerna för den medlemmen. XamlReader Mer specifikt har flera abstrakta medlemmar som måste implementeras och flera virtuella medlemmar.

Av de virtuella medlemmarna ReadSubtree , och var och Skip en ger en standardimplementering som är lämplig för de flesta fall. Standardimplementeringarna och Skip förlitar sig dock ReadSubtree på annat förväntat beteende hos den implementerande XAML-läsaren. I synnerhet förlitar de sig på åsidosättningenRead. Dispose är också en virtuell medlem som har en fungerande standardimplementering.

Följande två klasser är de mest relevanta och praktiska härledda klasserna i .NET Framework XAML Services och System.Xaml-sammansättningen:

  • XamlObjectReader, som läser ett objektdiagram, till exempel det aktiva objektdiagrammet för ett program vid körning.

  • XamlXmlReader, som läser XAML i form av en XML-textfil med hjälp av en allmän XmlReader fil som läser in filen som en mellanliggande hjälpklass.

Andra XAML-läsare från andra ramverk är Baml2006Reader och XamlDebuggerXmlReader.

XamlReader skiljer sig från XML Document Object Model (DOM) och XmlReader designprinciper eftersom XamlReader det inte finns någon Create metod för att returnera underliggande standardimplementeringar för XAML-läsare. Du måste i stället instansiera specifika härledda XAML-läsarklasser genom att anropa deras konstruktorer eller andra klassspecifika hjälp-API:er.

Underträdsläsare

För det mesta anropar XamlReader du API i kontexten för specifika XAML-läsarklasser som härleds från XamlReader. I ett visst fall får du dock åtkomst till XamlReader API:et på en praktisk XAML-läsarinstans som inte är offentlig och inte härledd från XamlObjectReader eller XamlXmlReader. Det här fallet är när du anropar ReadSubtree, som returnerar en XamlReader instans. I standardimplementeringen XamlReader är det som returneras av det här API:et en intern klass.

Den XamlReader som hämtas för underträdsläsning har giltiga åtgärder för API:er som Read och NodeType, och dessa åtgärder baseras på den överordnade läsarklassen. Den här designen gör det möjligt för den interna klassen att spåra bildrutenivån där underträdet angavs. Det tillförordnade underträdet XamlReader ser till att om den aktuella nodpositionen flyttas utanför gränserna för underträdet rapporterar den specifika underträdsläsaren filslut eller null på den aktuella noden.

Anteckningar om underträdsläsaranvändning ingår i vissa XamlReader API:er.

Konstruktorer

Name Description
XamlReader()

Initierar klassen XamlReader.

Egenskaper

Name Description
IsDisposed

Får reda på om Dispose(Boolean) har anropats.
IsEof

När det implementeras i en härledd klass får du ett värde som rapporterar om läsarpositionen är i slutet av filen.
Member

När den implementeras i en härledd klass hämtar den aktuella medlemmen på läsarpositionen, om läsarpositionen är på en StartMember.
Namespace

När den implementeras i en härledd klass hämtar du XAML-namnområdesinformationen från den aktuella noden.
NodeType

När den implementeras i en härledd klass hämtar den aktuella nodens typ.
SchemaContext

När det implementeras i en härledd klass hämtar ett objekt som tillhandahåller XAML-schemakontextinformation för informationsuppsättningen.
Type

När den implementeras i en härledd klass hämtar den XamlType aktuella noden.
Value

När den implementeras i en härledd klass hämtar du värdet för den aktuella noden.

Metoder

Name Description
Close()

Stänger XAML-nodströmmen.
Dispose(Boolean)

Släpper de ohanterade resurser som används av XamlReader, och du kan också frigöra de hanterade resurserna.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Read()

När den implementeras i en härledd klass, tillhandahåller nästa XAML-nod från källan, om en nod är tillgänglig.
ReadSubtree()

Returnerar ett XamlReader som baseras på den aktuella XamlReader, där den returnerade XamlReader används för att iterera via ett underträd i XAML-nodstrukturen.
Skip()

Hoppar över den aktuella noden och flyttar läsarens position till nästa nod.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Explicita gränssnittsimplementeringar

Name Description
IDisposable.Dispose()

Släpper alla resurser som används av den aktuella instansen XamlReader av klassen.

Gäller för

Se även