Condividi tramite


XPathNavigator Classe

Definizione

Fornisce un modello di cursore per esplorare e modificare dati XML.

public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, ICloneable, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : ICloneable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    inherit XPathItem
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    interface ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXPathNavigable
    interface IXmlNamespaceResolver
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Implements ICloneable
Ereditarietà
XPathNavigator
Ereditarietà
XPathNavigator
Derivato
Implementazioni

Commenti

La XPathNavigator classe nello System.Xml.XPath spazio dei nomi è una classe astratta che definisce un modello di cursore per lo spostamento e la modifica di elementi di informazioni XML come istanze del modello di dati XQuery 1.0 e XPath 2.0.

Un XPathNavigator oggetto viene creato da una classe che implementa l'interfaccia IXPathNavigable , ad esempio le XPathDocument classi e XmlDocument . XPathNavigatorgli oggetti creati dagli oggetti sono di sola lettura mentre XPathNavigator gli oggetti creati dagli XPathDocumentXmlDocument oggetti possono essere modificati. Lo stato di sola lettura o modificabile di un XPathNavigator oggetto viene determinato usando la CanEdit proprietà della XPathNavigator classe.

Per altre informazioni sull'elaborazione dei dati XML tramite il modello di dati XPath, vedere l'argomento Elaborare dati XML usando il modello di dati XPath .

Importante

Le eccezioni generate come risultato dell'uso della classe, ad esempio la XPathNavigatorXPathException classe, possono contenere informazioni riservate che non devono essere esposte in scenari non attendibili. Le eccezioni devono essere gestite correttamente in modo che queste informazioni riservate non siano esposte in scenari non attendibili.

Note per gli implementatori

Quando si eredita dalla classe, è necessario eseguire l'override XPathNavigator dei membri seguenti:

Costruttori

XPathNavigator()

Inizializza una nuova istanza della classe XPathNavigator.

Proprietà

BaseURI

Quando sottoposto a override in una classe derivata, ottiene l'URI di base del nodo corrente.

CanEdit

Ottiene un valore che indica se XPathNavigator può modificare i dati XML sottostanti.

HasAttributes

Ottiene un valore che indica se il nodo corrente ha attributi.

HasChildren

Ottiene un valore che indica se il nodo corrente ha nodi figlio.

InnerXml

Ottiene o imposta il markup che rappresenta i nodi figlio del nodo corrente.

IsEmptyElement

Quando ne viene eseguito l'override in una classe derivata, ottiene un valore che indica se il nodo corrente rappresenta un elemento vuoto senza un tag di fine dell'elemento.

IsNode

Ottiene un valore che indica se il nodo corrente rappresenta un nodo XPath.

LocalName

Quando ne viene eseguito l'override in una classe derivata, ottiene l'oggetto Name del nodo corrente senza prefisso dello spazio dei nomi.

Name

Quando ne viene eseguito l'override in una classe derivata, ottiene il nome completo del nodo corrente.

NamespaceURI

Quando sottoposto a override in una classe derivata, ottiene l'URI dello spazio dei nomi del nodo corrente.

NameTable

Quando viene sottoposto a override in una classe derivata ottiene l'oggetto XmlNameTable della classe XPathNavigator.

NavigatorComparer

Ottiene un'interfaccia IEqualityComparer usata per il confronto di uguaglianza di oggetti XPathNavigator.

NodeType

Quando sottoposto a override in una classe derivata, ottiene l'enumerazione XPathNodeType del nodo corrente.

OuterXml

Ottiene o imposta il markup che rappresenta i tag di apertura e di chiusura del nodo corrente e dei relativi nodi figlio.

Prefix

Quando sottoposto a override in una classe derivata, ottiene il prefisso dello spazio dei nomi associato al nodo corrente.

SchemaInfo

Ottiene le informazioni sullo schema assegnate al nodo corrente in seguito alla convalida dello schema.

TypedValue

Ottiene il nodo corrente come oggetto boxed del tipo .NET più appropriato.

UnderlyingObject

Utilizzato dalle implementazioni di XPathNavigator che forniscono una visualizzazione XML "virtuale" di un archivio per consentire l'accesso agli oggetti sottostanti.

Value

Quando viene sottoposto a override in una classe derivata, ottiene il valore stringa dell'elemento.

Value

Quando sottoposto a override in una classe derivata, ottiene il valore string dell'elemento.

(Ereditato da XPathItem)
ValueAsBoolean

Ottiene il valore del nodo corrente come Boolean.

ValueAsDateTime

Ottiene il valore del nodo corrente come DateTime.

ValueAsDouble

Ottiene il valore del nodo corrente come Double.

ValueAsInt

Ottiene il valore del nodo corrente come Int32.

ValueAsLong

Ottiene il valore del nodo corrente come Int64.

ValueType

Ottiene il valore .NET Type del nodo corrente.

XmlLang

Ottiene l'ambito per il xml:lang nodo corrente.

XmlType

Ottiene le informazioni sul tipo XmlSchemaType per il nodo corrente.

XmlType

Quando sottoposto a override in una classe derivata, ottiene l'oggetto XmlSchemaType per l'elemento.

(Ereditato da XPathItem)

Metodi

AppendChild()

Restituisce un oggetto XmlWriter utilizzato per creare uno o più nodi figlio nuovi alla fine dell'elenco dei nodi figlio del nodo corrente.

AppendChild(String)

Crea un nuovo nodo figlio alla fine dell'elenco dei nodi figlio del nodo corrente usando la stringa di dati XML specificata.

AppendChild(XmlReader)

Crea un nuovo nodo figlio alla fine dell'elenco dei nodi figlio del nodo corrente usando il contenuto XML dell'oggetto XmlReader specificato.

AppendChild(XPathNavigator)

Crea un nuovo nodo figlio alla fine dell'elenco dei nodi figlio del nodo corrente usando i nodi nella classe XPathNavigator specificata.

AppendChildElement(String, String, String, String)

Crea un nuovo nodo elemento figlio alla fine dell'elenco dei nodi figlio del nodo corrente usando il prefisso dello spazio dei nomi, il nome locale e l'URI dello spazio dei nomi specificati con il valore specificato.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Verifica che i dati XML nella classe XPathNavigator siano conformi allo schema XSD (XML Schema Definition Language) specificato.

Clone()

Se sottoposto a override in una classe derivata, crea una nuova classe XPathNavigator posizionata sullo stesso nodo della classe XPathNavigator.

ComparePosition(XPathNavigator)

Confronta la posizione dell'oggetto XPathNavigator corrente con quello dell'oggetto XPathNavigator specificato.

Compile(String)

Compila una stringa che rappresenta un'espressione XPath e restituisce un oggetto XPathExpression.

CreateAttribute(String, String, String, String)

Crea un nodo attributo in corrispondenza del nodo elemento corrente usando il prefisso dello spazio dei nomi, il nome locale e l'URI dello spazio dei nomi specificati con il valore specificato.

CreateAttributes()

Restituisce un oggetto XmlWriter utilizzato per creare nuovi attributi nell'elemento corrente.

CreateNavigator()

Restituisce una copia dell'oggetto XPathNavigator.

DeleteRange(XPathNavigator)

Elimina un intervallo di nodi di pari livello dal nodo corrente per il nodo specificato.

DeleteSelf()

Elimina il nodo corrente e i relativi nodi figlio.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Evaluate(String)

Valuta l'espressione XPath specificata e restituisce il risultato tipizzato.

Evaluate(String, IXmlNamespaceResolver)

Valuta l'espressione XPath specificata e restituisce il risultato tipizzato utilizzando l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi degli spazi dei nomi contenuti nell'espressione XPath.

Evaluate(XPathExpression)

Valuta la classe XPathExpression e restituisce il risultato tipizzato.

Evaluate(XPathExpression, XPathNodeIterator)

Utilizza il contesto specificato per valutare l'oggetto XPathExpression e restituisce il risultato tipizzato.

GetAttribute(String, String)

Ottiene il valore dell'attributo con il nome locale e l'URI dello spazio dei nomi specificati.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetNamespace(String)

Restituisce il valore del nodo spazio dei nomi corrispondente al nome locale specificato.

GetNamespacesInScope(XmlNamespaceScope)

Restituisce gli spazi dei nomi nell'ambito del nodo corrente.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
InsertAfter()

Restituisce un oggetto XmlWriter utilizzato per creare un nuovo nodo di pari livello successivo al nodo attualmente selezionato.

InsertAfter(String)

Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato usando la stringa XML specificata.

InsertAfter(XmlReader)

Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato usando il contenuto XML dell'oggetto XmlReader specificato.

InsertAfter(XPathNavigator)

Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato usando i nodi dell'oggetto XPathNavigator specificato.

InsertBefore()

Restituisce un oggetto XmlWriter utilizzato per creare un nuovo nodo di pari livello prima del nodo attualmente selezionato.

InsertBefore(String)

Crea un nuovo nodo di pari livello prima del nodo attualmente selezionato usando la stringa XML specificata.

InsertBefore(XmlReader)

Crea un nuovo nodo di pari livello prima del nodo attualmente selezionato usando il contenuto XML dell'oggetto XmlReader specificato.

InsertBefore(XPathNavigator)

Crea un nuovo nodo di pari livello prima del nodo attualmente selezionato usando i nodi dell’oggetto XPathNavigator specificato.

InsertElementAfter(String, String, String, String)

Crea un nuovo elemento di pari livello dopo il nodo corrente usando il prefisso dello spazio dei nomi, il nome locale e l'URI dello spazio dei nomi specificati con il valore specificato.

InsertElementBefore(String, String, String, String)

Crea un nuovo elemento di pari livello prima del nodo corrente usando il prefisso dello spazio dei nomi, il nome locale e l'URI dello spazio dei nomi specificati con il valore specificato.

IsDescendant(XPathNavigator)

Determina se l'oggetto XPathNavigator specificato è un discendente dell'oggetto XPathNavigator corrente.

IsSamePosition(XPathNavigator)

Se sottoposto a override in una classe derivata, determina se l'oggetto XPathNavigator corrente si trova nella stessa posizione dell'oggetto XPathNavigator specificato.

LookupNamespace(String)

Ottiene l'URI dello spazio dei nomi per il prefisso specificato.

LookupPrefix(String)

Ottiene il prefisso dichiarato per l'URI dello spazio dei nomi specificato.

Matches(String)

Determina se il nodo corrente corrisponde all'espressione XPath specificata.

Matches(XPathExpression)

Determina se il nodo corrente corrisponde all'espressione XPathExpression specificata.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MoveTo(XPathNavigator)

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator nella stessa posizione dell'oggetto XPathNavigator specificato.

MoveToAttribute(String, String)

Sposta l'oggetto XPathNavigator sull'attributo con il nome locale e l'URI dello spazio dei nomi corrispondenti.

MoveToChild(String, String)

Sposta l'oggetto XPathNavigator sul nodo figlio con il nome locale e l'URI dello spazio dei nomi specificati.

MoveToChild(XPathNodeType)

Sposta l'oggetto XPathNavigator sul nodo figlio dell'enumerazione XPathNodeType specificata.

MoveToFirst()

Sposta il tipo XPathNavigator sul primo nodo di pari livello del nodo corrente.

MoveToFirstAttribute()

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul primo attributo del nodo corrente.

MoveToFirstChild()

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul primo nodo figlio del nodo corrente.

MoveToFirstNamespace()

Sposta l'oggetto XPathNavigator sul primo nodo spazio dei nomi del nodo corrente.

MoveToFirstNamespace(XPathNamespaceScope)

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul primo nodo spazio dei nomi corrispondente all'enumerazione XPathNamespaceScope specificata.

MoveToFollowing(String, String)

Sposta l'oggetto XPathNavigator sull'elemento con il nome locale e l'URI dello spazio dei nomi specificati nell'ordine dei documenti.

MoveToFollowing(String, String, XPathNavigator)

Sposta l'oggetto XPathNavigator sull'elemento con il nome locale e l'URI dello spazio dei nomi specificati, sul limite specificato, nell'ordine dei documenti.

MoveToFollowing(XPathNodeType)

Sposta l'oggetto XPathNavigator sull'elemento seguente dell'enumerazione XPathNodeType specificato nell'ordine dei documenti.

MoveToFollowing(XPathNodeType, XPathNavigator)

Sposta l'oggetto XPathNavigator sull'elemento seguente dell'enumerazione XPathNodeType specificato, sul limite specificato, nell'ordine dei documenti.

MoveToId(String)

Quando ne viene eseguito l'override in una classe derivata, passa al nodo con un attributo di tipo ID il cui valore corrisponde all'oggetto specificato String.

MoveToNamespace(String)

Sposta l'oggetto XPathNavigator sul nodo spazio dei nomi con il prefisso dello spazio dei nomi specificato.

MoveToNext()

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul nodo di pari livello successivo del nodo corrente.

MoveToNext(String, String)

Sposta l'oggetto XPathNavigator sul nodo di pari livello successivo con il nome locale e l'URI dello spazio dei nomi specificati.

MoveToNext(XPathNodeType)

Sposta l'oggetto XPathNavigator sul nodo di pari livello successivo del nodo corrente corrispondente al tipo di nodo XPathNodeType specificato.

MoveToNextAttribute()

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator all'attributo successivo.

MoveToNextNamespace()

Sposta l'oggetto XPathNavigator sul successivo nodo spazio dei nomi.

MoveToNextNamespace(XPathNamespaceScope)

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul nodo spazio dei nomi successivo corrispondente all'enumerazione XPathNamespaceScope specificata.

MoveToParent()

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul nodo padre del nodo corrente.

MoveToPrevious()

Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul nodo di pari livello precedente al nodo corrente.

MoveToRoot()

Sposta l'oggetto XPathNavigator sul nodo radice a cui appartiene il nodo corrente.

PrependChild()

Restituisce un oggetto XmlWriter utilizzato per creare un nuovo nodo figlio all'inizio dell'elenco dei nodi figlio del nodo corrente.

PrependChild(String)

Crea un nuovo nodo figlio all'inizio dell'elenco di nodi figlio del nodo corrente usando la stringa XML specificata.

PrependChild(XmlReader)

Crea un nuovo nodo figlio all'inizio dell'elenco di nodi figlio del nodo corrente usando il contenuto XML dell'oggetto XmlReader specificato.

PrependChild(XPathNavigator)

Crea un nuovo nodo figlio all'inizio dell'elenco di nodi figlio del nodo corrente usando i nodi dell'oggetto XPathNavigator specificato.

PrependChildElement(String, String, String, String)

Crea un nuovo elemento figlio all'inizio dell'elenco di nodi figlio del nodo corrente usando il prefisso dello spazio dei nomi, il nome locale e l'URI dello spazio dei nomi specificati con il valore specificato.

ReadSubtree()

Restituisce un oggetto XmlReader contenente il nodo corrente e i relativi nodi figlio.

ReplaceRange(XPathNavigator)

Sostituisce un intervallo di nodi di pari livello dal nodo corrente per il nodo specificato.

ReplaceSelf(String)

Sostituisce il nodo corrente con il contenuto della stringa specificato.

ReplaceSelf(XmlReader)

Sostituisce il nodo corrente con il contenuto dell'oggetto XmlReader specificato.

ReplaceSelf(XPathNavigator)

Sostituisce il nodo corrente con il contenuto dell'oggetto XPathNavigator specificato.

Select(String)

Seleziona un insieme di nodi utilizzando l'espressione XPath specificata.

Select(String, IXmlNamespaceResolver)

Seleziona un insieme di nodi utilizzando l'espressione XPath specificata con l'oggetto IXmlNamespaceResolver specificato per la risoluzione dei prefissi degli spazi dei nomi.

Select(XPathExpression)

Seleziona un insieme di nodi utilizzando l'oggetto XPathExpression specificato.

SelectAncestors(String, String, Boolean)

Seleziona tutti i nodi predecessore del nodo corrente con il nome locale e l'URI dello spazio dei nomi specificati.

SelectAncestors(XPathNodeType, Boolean)

Seleziona tutti i nodi predecessore del nodo corrente che presentano un oggetto XPathNodeType corrispondente.

SelectChildren(String, String)

Seleziona tutti i nodi figlio del nodo corrente con il nome locale e l'URI dello spazio dei nomi specificati.

SelectChildren(XPathNodeType)

Seleziona tutti i nodi figlio del nodo corrente con l'oggetto XPathNodeType corrispondente.

SelectDescendants(String, String, Boolean)

Seleziona tutti i nodi discendente del nodo corrente con il nome locale e l'URI dello spazio dei nomi specificati.

SelectDescendants(XPathNodeType, Boolean)

Seleziona tutti i nodi discendente del nodo corrente che presentano un oggetto XPathNodeType corrispondente.

SelectSingleNode(String)

Seleziona un singolo nodo della classe XPathNavigator utilizzando la query XPath specificata.

SelectSingleNode(String, IXmlNamespaceResolver)

Seleziona un singolo nodo nell'oggetto XPathNavigator utilizzando la query XPath specificata con l'oggetto IXmlNamespaceResolver specificato per la risoluzione dei prefissi degli spazi dei nomi.

SelectSingleNode(XPathExpression)

Seleziona un singolo nodo della classe XPathNavigator utilizzando l'oggetto XPathExpression specificato.

SetTypedValue(Object)

Imposta il valore tipizzato del nodo corrente.

SetValue(String)

Imposta il valore del nodo corrente.

ToString()

Ottiene il valore di testo del nodo corrente.

ValueAs(Type)

Restituisce il valore dell'elemento in base al tipo specificato.

(Ereditato da XPathItem)
ValueAs(Type, IXmlNamespaceResolver)

Ottiene il valore del nodo corrente come valore Type specificato utilizzando l'oggetto IXmlNamespaceResolver specificato per la risoluzione dei prefissi degli spazi dei nomi.

WriteSubtree(XmlWriter)

Crea un flusso del nodo corrente e dei relativi nodi figlio verso l'oggetto XmlWriter specificato.

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()

Crea una nuova copia dell'oggetto XPathNavigator corrente.

Si applica a

Vedi anche