XamlReader Classe

Definizione

Fornisce le definizioni di base per le classi che utilizzano l'input XAML e producono flussi del nodo XAML.Provides base definitions for classes that consume XAML input and produce XAML node streams.

public ref class XamlReader abstract : IDisposable
public abstract class XamlReader : IDisposable
type XamlReader = class
    interface IDisposable
Public MustInherit Class XamlReader
Implements IDisposable
Ereditarietà
XamlReader
Derivato
Implementazioni

Commenti

XamlReaderè una classe astratta e non fornisce implementazioni o definizioni che hanno un risultato funzionante per tutti i membri.XamlReader is an abstract class and does not provide implementations or definitions that have a working result for all members. I membri che dispongono di un'implementazione XamlReader in sono indicati nei commenti relativi a tale membro.Members that do have an implementation in XamlReader are noted in the remarks for that member. In particolare XamlReader , include diversi membri astratti che devono essere implementati e diversi membri virtuali.Specifically, XamlReader has several abstract members that must be implemented, and several virtual members.

Dei membri ReadSubtree virtuali e Skip ognuno di essi fornisce un'implementazione predefinita appropriata per la maggior parte dei casi.Of the virtual members, ReadSubtree and Skip each provide a default implementation that is appropriate for most cases. Tuttavia, le ReadSubtree implementazioni predefinite e Skip si basano su altro comportamento previsto del reader XAML di implementazione; in particolare Read , si basano sull'override.However, the ReadSubtree and Skip default implementations rely on other expected behavior of the implementing XAML reader; in particular, they rely on the Read override. Disposeè anche un membro virtuale che dispone di un'implementazione predefinita funzionante.Dispose is also a virtual member that has a working default implementation.

Le due classi seguenti sono le classi derivate più rilevanti e pratiche in .NET Framework i servizi XAML e l'assembly System. XAML:The following two classes are the most relevant and practical derived classes in .NET Framework XAML Services and the System.Xaml assembly:

  • XamlObjectReader, che legge un oggetto grafico, ad esempio l'oggetto grafico attivo di un'applicazione in fase di esecuzione.XamlObjectReader, which reads an object graph, such as the active object graph of an application at run time.

  • XamlXmlReader, che legge XAML sotto forma di file di testo XML utilizzando un generale XmlReader che carica il file come classe helper intermediario.XamlXmlReader, which reads XAML in the form of a XML text file by using a general XmlReader that loads the file as an intermediary helper class.

Altri lettori XAML di altri Framework includono Baml2006Reader e. XamlDebuggerXmlReaderOther XAML readers from other frameworks include Baml2006Reader and XamlDebuggerXmlReader.

XamlReaderdifferisce da XML DOM (Document Object Model)XML Document Object Model (DOM) e XmlReader dai principi di XamlReader progettazione perché non dispone Create di un metodo per restituire le implementazioni del reader XAML predefinite sottostanti.XamlReader differs from XML DOM (Document Object Model)XML Document Object Model (DOM) and XmlReader design principles because XamlReader does not have a Create method to return underlying default XAML reader implementations. È invece necessario creare istanze di classi di reader XAML derivate specifiche chiamando i relativi costruttori o altre API helper specifiche della classe.You must instead instantiate specific derived XAML reader classes by calling their constructors or other class-specific helper APIs.

Lettori di sottoalberoSubtree Readers

Nella maggior parte dei casi, si XamlReader chiama l'API nel contesto di classi reader XAML specifiche che derivano da. XamlReaderFor the most part, you call XamlReader API in the context of specific XAML reader classes that derive from XamlReader. Tuttavia, in un caso particolare, si accede XamlReader all'API su un'istanza di reader XAML pratica non pubblica e non derivata da XamlObjectReader o XamlXmlReader.However, in one particular case, you access XamlReader API on a practical XAML reader instance that is not public and not derived from XamlObjectReader or XamlXmlReader. Questo caso si verifica quando si ReadSubtreechiama, che restituisce XamlReader un'istanza di.This case is when you call ReadSubtree, which returns a XamlReader instance. Nell'implementazione predefinita, l'oggetto XamlReader restituito da questa API è una classe interna.In the default implementation, the XamlReader that is returned by this API is an internal class.

L' XamlReader oggetto ottenuto per la lettura del sottoalbero presenta azioni valide Read per NodeTypele API, ad esempio e, e tali azioni sono basate sulla classe reader padre.The XamlReader obtained for subtree reading has valid actions for APIs such as Read and NodeType, and those actions are based on the parent reader class. Questa progettazione consente alla classe interna di tenere traccia del livello di frame in cui è stato immesso il sottoalbero.This design enables the internal class to track the frame level where the subtree was entered. Il sottoalbero XamlReader di azione verifica che se la posizione corrente del nodo viene spostata oltre i limiti del sottoalbero, il lettore di sottoalbero specifico segnala la fine null del file o il nodo corrente.The acting subtree XamlReader makes sure that if the current node position is moved beyond the bounds of the subtree, the specific subtree reader reports end-of-file or null at the current node.

Note sull'utilizzo del lettore di sottoalbero sono XamlReader incluse in determinate API.Notes about subtree reader usage are included on certain XamlReader APIs.

Costruttori

XamlReader()

Inizializza la classe XamlReader.Initializes the XamlReader class.

Proprietà

IsDisposed

Ottiene un valore che indica se Dispose(Boolean) è stato chiamato.Gets whether Dispose(Boolean) has been called.

IsEof

Quando implementato in una classe derivata, ottiene un valore che indica se la posizione del reader è alla fine del file.When implemented in a derived class, gets a value that reports whether the reader position is at end-of-file.

Member

Quando implementato in una classe derivata, ottiene il membro corrente nella posizione del reader, se la posizione del reader è in un oggetto StartMember.When implemented in a derived class, gets the current member at the reader position, if the reader position is on a StartMember.

Namespace

Quando implementato in una classe derivata, ottiene le informazioni sullo spazio dei nomi XAML del nodo corrente.When implemented in a derived class, gets the XAML namespace information from the current node.

NodeType

Quando implementato in una classe derivata, ottiene il tipo del nodo corrente.When implemented in a derived class, gets the type of the current node.

SchemaContext

Quando implementato in una classe derivata, ottiene un oggetto che fornisce le informazioni sul contesto dello schema XAML per il set di informazioni.When implemented in a derived class, gets an object that provides XAML schema context information for the information set.

Type

Quando implementato in una classe derivata, ottiene l'oggetto XamlType del nodo corrente.When implemented in a derived class, gets the XamlType of the current node.

Value

Quando implementato in una classe derivata, ottiene il valore del nodo corrente.When implemented in a derived class, gets the value of the current node.

Metodi

Close()

Chiude il flusso del nodo XAML.Closes the XAML node stream.

Dispose(Boolean)

Rilascia le risorse non gestite utilizzate dall'oggetto XamlReader e facoltativamente rilascia le risorse gestite.Releases the unmanaged resources used by the XamlReader, and optionally, releases the managed resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Read()

Quando implementato in una classe derivata, fornisce il nodo XAML successivo dall'origine, se è disponibile un nodo.When implemented in a derived class, provides the next XAML node from the source, if a node is available.

ReadSubtree()

Restituisce un oggetto XamlReader basato sull'oggetto XamlReader corrente, dove l'oggetto XamlReader restituito viene utilizzato per scorrere un sottoalbero della struttura dei nodi XAML.Returns a XamlReader that is based on the current XamlReader, where the returned XamlReader is used to iterate through a subtree of the XAML node structure.

Skip()

Ignora il nodo corrente e fa avanzare la posizione del reader al nodo successivo.Skips the current node and advances the reader position to the next node.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Rilascia tutte le risorse usate dall'istanza corrente della classe XamlReader.Releases all resources used by the current instance of the XamlReader class.

Si applica a

Vedi anche