XPathNavigator Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un modello di cursore per lo spostamento e la modifica di 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à
- 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 . XPathNavigator gli oggetti creati dagli XPathDocument oggetti sono di sola lettura mentre XPathNavigator gli oggetti creati dagli XmlDocument 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 di dati XML tramite il modello di dati XPath, vedere l'argomento Elaborare dati XML tramite il modello di dati XPath .
Importante
Le eccezioni generate in seguito all'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 vengano esposte in scenari non attendibili.
Note per gli implementatori
Quando si eredita dalla XPathNavigator classe , è necessario eseguire l'override dei membri seguenti:
Costruttori
| Nome | Descrizione |
|---|---|
| XPathNavigator() |
Inizializza una nuova istanza della classe XPathNavigator. |
Proprietà
| Nome | Descrizione |
|---|---|
| BaseURI |
Quando sottoposto a override in una classe derivata, ottiene l'URI di base per il nodo corrente. |
| CanEdit |
Ottiene un valore che indica se può XPathNavigator modificare i dati XML sottostanti. |
| HasAttributes |
Ottiene un valore che indica se il nodo corrente dispone di attributi. |
| HasChildren |
Ottiene un valore che indica se il nodo corrente dispone di nodi figlio. |
| InnerXml |
Ottiene o imposta il markup che rappresenta i nodi figlio del nodo corrente. |
| IsEmptyElement |
In caso di override in una classe derivata, ottiene un valore che indica se il nodo corrente è un elemento vuoto senza un tag di elemento finale. |
| IsNode |
Ottiene un valore che indica se il nodo corrente rappresenta un nodo XPath. |
| LocalName |
In caso di override in una classe derivata, ottiene l'oggetto Name del nodo corrente senza alcun prefisso dello spazio dei nomi. |
| Name |
In caso di 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 sottoposto a override in una classe derivata, ottiene l'oggetto dell'oggetto XmlNameTableXPathNavigator. |
| NavigatorComparer |
Ottiene un IEqualityComparer oggetto utilizzato per il confronto di uguaglianza degli XPathNavigator oggetti. |
| NodeType |
Quando sottoposto a override in una classe derivata, ottiene l'oggetto XPathNodeType del nodo corrente. |
| OuterXml |
Ottiene o imposta il markup che rappresenta i tag di apertura e chiusura del nodo corrente e dei relativi nodi figlio. |
| Prefix |
In caso di 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 |
Usato dalle XPathNavigator implementazioni che forniscono una visualizzazione XML "virtualizzata" su un archivio, per fornire l'accesso agli oggetti sottostanti. |
| Value |
In caso di override in una classe derivata, ottiene il valore stringa dell'elemento. |
| Value |
In caso di override in una classe derivata, ottiene il |
| 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 .NET Type del nodo corrente. |
| XmlLang |
Ottiene l'ambito |
| XmlType |
Ottiene le XmlSchemaType informazioni per il nodo corrente. |
Metodi
| Nome | Descrizione |
|---|---|
| AppendChild() |
Restituisce un XmlWriter oggetto utilizzato per creare uno o più nuovi nodi figlio 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 utilizzando 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 nell'oggetto XPathNavigator specificato. |
| 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 nell'oggetto XPathNavigator siano conformi allo schema XSD (XML Schema Definition Language) fornito. |
| Clone() |
Quando sottoposto a override in una classe derivata, crea un nuovo XPathNavigator posizionato nello stesso nodo di questo XPathNavigatoroggetto . |
| ComparePosition(XPathNavigator) |
Confronta la posizione dell'oggetto corrente XPathNavigator con la posizione dell'oggetto XPathNavigator specificato. |
| Compile(String) |
Compila una stringa che rappresenta un'espressione XPath e restituisce un XPathExpression oggetto . |
| CreateAttribute(String, String, String, String) |
Crea un nodo attributo nel nodo dell'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 XmlWriter oggetto 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 al 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, IXmlNamespaceResolver) |
Valuta l'espressione XPath specificata e restituisce il risultato tipizzato, utilizzando l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi dello spazio dei nomi nell'espressione XPath. |
| Evaluate(String) |
Valuta l'espressione XPath specificata e restituisce il risultato tipizzato. |
| Evaluate(XPathExpression, XPathNodeIterator) |
Usa il contesto fornito per valutare e XPathExpressionrestituisce il risultato tipizzato. |
| Evaluate(XPathExpression) |
Valuta e XPathExpression 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 dello spazio dei nomi corrispondente al nome locale specificato. |
| GetNamespacesInScope(XmlNamespaceScope) |
Restituisce gli spazi dei nomi nell'ambito del nodo corrente. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InsertAfter() |
Restituisce un XmlWriter oggetto utilizzato per creare un nuovo nodo di pari livello dopo il nodo attualmente selezionato. |
| InsertAfter(String) |
Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato utilizzando la stringa XML specificata. |
| InsertAfter(XmlReader) |
Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato utilizzando il contenuto XML dell'oggetto XmlReader specificato. |
| InsertAfter(XPathNavigator) |
Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato usando i nodi nell'oggetto XPathNavigator specificato. |
| InsertBefore() |
Restituisce un XmlWriter oggetto 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 utilizzando la stringa XML specificata. |
| InsertBefore(XmlReader) |
Crea un nuovo nodo di pari livello prima del nodo attualmente selezionato utilizzando il contenuto XML dell'oggetto XmlReader specificato. |
| InsertBefore(XPathNavigator) |
Crea un nuovo nodo di pari livello prima del nodo attualmente selezionato usando i nodi nell'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 specificato XPathNavigator è un discendente dell'oggetto corrente XPathNavigator. |
| IsSamePosition(XPathNavigator) |
Quando sottoposto a override in una classe derivata, determina se l'oggetto corrente XPathNavigator si trova nella stessa posizione dell'oggetto specificato XPathNavigator. |
| 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'oggetto specificato XPathExpression. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MoveTo(XPathNavigator) |
Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator nella stessa posizione dell'oggetto specificato XPathNavigator. |
| 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 nel nodo figlio con il nome locale e l'URI dello spazio dei nomi specificati. |
| MoveToChild(XPathNodeType) |
Sposta l'oggetto XPathNavigator nel nodo figlio dell'oggetto XPathNodeType specificato. |
| MoveToFirst() |
Sposta l'oggetto XPathNavigator nel 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 nel XPathNavigator primo nodo dello spazio dei nomi del nodo corrente. |
| MoveToFirstNamespace(XPathNamespaceScope) |
Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator nel primo nodo dello spazio dei nomi corrispondente all'oggetto XPathNamespaceScope specificato. |
| MoveToFollowing(String, String, XPathNavigator) |
Sposta l'oggetto XPathNavigator sull'elemento con il nome locale e l'URI dello spazio dei nomi specificati, nel limite specificato, nell'ordine del documento. |
| MoveToFollowing(String, String) |
Sposta l'oggetto XPathNavigator sull'elemento con il nome locale e l'URI dello spazio dei nomi specificato nell'ordine del documento. |
| MoveToFollowing(XPathNodeType, XPathNavigator) |
Sposta l'oggetto XPathNavigator sull'elemento seguente dell'oggetto XPathNodeType specificato, al limite specificato, nell'ordine del documento. |
| MoveToFollowing(XPathNodeType) |
Sposta l'oggetto XPathNavigator sull'elemento seguente dell'oggetto specificato nell'ordine del XPathNodeType documento. |
| MoveToId(String) |
Quando sottoposto a override in una classe derivata, passa al nodo con un attributo di tipo |
| MoveToNamespace(String) |
Sposta l'oggetto XPathNavigator nel nodo dello spazio dei nomi con il prefisso dello spazio dei nomi specificato. |
| MoveToNext() |
Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator nel nodo di pari livello successivo del nodo corrente. |
| MoveToNext(String, String) |
Sposta l'oggetto XPathNavigator nel nodo di pari livello successivo con il nome locale e l'URI dello spazio dei nomi specificati. |
| MoveToNext(XPathNodeType) |
Sposta l'oggetto XPathNavigator nel nodo di pari livello successivo del nodo corrente che corrisponde all'oggetto XPathNodeType specificato. |
| MoveToNextAttribute() |
Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sull'attributo successivo. |
| MoveToNextNamespace() |
Sposta l'oggetto XPathNavigator nel nodo dello spazio dei nomi successivo. |
| MoveToNextNamespace(XPathNamespaceScope) |
Quando sottoposto a override in una classe derivata, sposta l'oggetto XPathNavigator sul nodo dello spazio dei nomi successivo corrispondente all'oggetto XPathNamespaceScope specificato. |
| 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 del nodo corrente. |
| MoveToRoot() |
Sposta l'oggetto XPathNavigator nel nodo radice a cui appartiene il nodo corrente. |
| PrependChild() |
Restituisce un XmlWriter oggetto utilizzato per creare un nuovo nodo figlio all'inizio dell'elenco di nodi figlio del nodo corrente. |
| PrependChild(String) |
Crea un nuovo nodo figlio all'inizio dell'elenco dei nodi figlio del nodo corrente usando la stringa XML specificata. |
| PrependChild(XmlReader) |
Crea un nuovo nodo figlio all'inizio dell'elenco dei nodi figlio del nodo corrente utilizzando il contenuto XML dell'oggetto XmlReader specificato. |
| PrependChild(XPathNavigator) |
Crea un nuovo nodo figlio all'inizio dell'elenco dei nodi figlio del nodo corrente usando i nodi nell'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 XmlReader oggetto che contiene il nodo corrente e i relativi nodi figlio. |
| ReplaceRange(XPathNavigator) |
Sostituisce un intervallo di nodi di pari livello dal nodo corrente al nodo specificato. |
| ReplaceSelf(String) |
Sostituisce il nodo corrente con il contenuto della stringa specificata. |
| 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, IXmlNamespaceResolver) |
Seleziona un set di nodi usando l'espressione XPath specificata con l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi dello spazio dei nomi. |
| Select(String) |
Seleziona un set di nodi usando l'espressione XPath specificata. |
| Select(XPathExpression) |
Seleziona un set di nodi usando l'oggetto specificato XPathExpression. |
| SelectAncestors(String, String, Boolean) |
Seleziona tutti i nodi predecessori del nodo corrente con il nome locale e l'URI dello spazio dei nomi specificati. |
| SelectAncestors(XPathNodeType, Boolean) |
Seleziona tutti i nodi predecessori del nodo corrente con un oggetto corrispondente XPathNodeType. |
| 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 corrispondente XPathNodeType. |
| SelectDescendants(String, String, Boolean) |
Seleziona tutti i nodi discendenti del nodo corrente con il nome locale e l'URI dello spazio dei nomi specificati. |
| SelectDescendants(XPathNodeType, Boolean) |
Seleziona tutti i nodi discendenti del nodo corrente con un oggetto corrispondente XPathNodeType. |
| SelectSingleNode(String, IXmlNamespaceResolver) |
Seleziona un singolo nodo nell'oggetto XPathNavigator usando la query XPath specificata con l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi dello spazio dei nomi. |
| SelectSingleNode(String) |
Seleziona un singolo nodo in XPathNavigator utilizzando la query XPath specificata. |
| SelectSingleNode(XPathExpression) |
Seleziona un singolo nodo in XPathNavigator utilizzando l'oggetto specificato XPathExpression . |
| 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, IXmlNamespaceResolver) |
Ottiene il valore del nodo corrente come Type specificato, utilizzando l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi dello spazio dei nomi. |
| ValueAs(Type) |
Restituisce il valore dell'elemento come tipo specificato. (Ereditato da XPathItem) |
| WriteSubtree(XmlWriter) |
Trasmette il nodo corrente e i relativi nodi figlio all'oggetto XmlWriter specificato. |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ICloneable.Clone() |
Crea una nuova copia dell'oggetto XPathNavigator . |