Freigeben über


XPathNavigator Klasse

Definition

Stellt ein Cursormodell zum Navigieren und Bearbeiten von XML-Daten bereit.

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
Vererbung
XPathNavigator
Vererbung
XPathNavigator
Abgeleitet
Implementiert

Hinweise

Die XPathNavigator Klasse im System.Xml.XPath Namespace ist eine abstrakte Klasse, die ein Cursormodell zum Navigieren und Bearbeiten von XML-Informationselementen als Instanzen des XQuery 1.0- und XPath 2.0-Datenmodells definiert.

Ein XPathNavigator Objekt wird aus einer Klasse erstellt, die die Schnittstelle wie z. B. die IXPathNavigableXPathDocument Klassen XmlDocument implementiert. XPathNavigator Von XPathDocument Objekten erstellte Objekte sind schreibgeschützt, während XPathNavigator von XmlDocument Objekten erstellte Objekte bearbeitet werden können. Der schreibgeschützte oder bearbeitbare Status eines XPathNavigator Objekts wird mithilfe der CanEdit Eigenschaft der XPathNavigator Klasse bestimmt.

Weitere Informationen zum Verarbeiten von XML-Daten mithilfe des XPath-Datenmodells finden Sie im Thema " Prozess-XML-Daten mithilfe des XPath-Datenmodells ".

Von Bedeutung

Ausnahmen, die aufgrund der Verwendung der XPathNavigator Klasse ausgelöst werden, z. B. die XPathException Klasse, können vertrauliche Informationen enthalten, die in nicht vertrauenswürdigen Szenarien nicht verfügbar gemacht werden sollten. Ausnahmen sollten ordnungsgemäß behandelt werden, damit diese vertraulichen Informationen in nicht vertrauenswürdigen Szenarien nicht verfügbar gemacht werden.

Hinweise für Ausführende

Wenn Sie von der XPathNavigator Klasse erben, müssen Sie die folgenden Member überschreiben:

Konstruktoren

Name Beschreibung
XPathNavigator()

Initialisiert eine neue Instanz der XPathNavigator-Klasse.

Eigenschaften

Name Beschreibung
BaseURI

Wenn sie in einer abgeleiteten Klasse überschrieben werden, ruft den Basis-URI für den aktuellen Knoten ab.

CanEdit

Ruft einen Wert ab, der angibt, ob die XPathNavigator zugrunde liegenden XML-Daten bearbeitet werden können.

HasAttributes

Ruft einen Wert ab, der angibt, ob der aktuelle Knoten attribute hat.

HasChildren

Ruft einen Wert ab, der angibt, ob der aktuelle Knoten über untergeordnete Knoten verfügt.

InnerXml

Dient zum Abrufen oder Festlegen des Markups, das die untergeordneten Knoten des aktuellen Knotens darstellt.

IsEmptyElement

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob der aktuelle Knoten ein leeres Element ohne ein Endelementtag ist.

IsNode

Ruft einen Wert ab, der angibt, ob der aktuelle Knoten einen XPath-Knoten darstellt.

LocalName

Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, ruft den Name aktuellen Knoten ohne Namespacepräfix ab.

Name

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der qualifizierte Name des aktuellen Knotens angezeigt.

NamespaceURI

Beim Überschreiben in einer abgeleiteten Klasse ruft der Namespace-URI des aktuellen Knotens ab.

NameTable

Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft die XmlNameTable der XPathNavigator.

NavigatorComparer

Ruft einen IEqualityComparer Vergleich der Gleichheit von XPathNavigator Objekten ab.

NodeType

Wenn sie in einer abgeleiteten Klasse überschrieben werden, ruft den XPathNodeType aktuellen Knoten ab.

OuterXml

Dient zum Abrufen oder Festlegen des Markups, das die öffnenden und schließenden Tags des aktuellen Knotens und seiner untergeordneten Knoten darstellt.

Prefix

Beim Überschreiben in einer abgeleiteten Klasse ruft das Namespacepräfix ab, das dem aktuellen Knoten zugeordnet ist.

SchemaInfo

Ruft die Schemainformationen ab, die dem aktuellen Knoten als Ergebnis der Schemaüberprüfung zugewiesen wurden.

TypedValue

Ruft den aktuellen Knoten als boxed -Objekt des am besten geeigneten .NET-Typs ab.

UnderlyingObject

Wird von XPathNavigator Implementierungen verwendet, die eine "virtualisierte" XML-Ansicht über einen Speicher bereitstellen, um Zugriff auf zugrunde liegende Objekte zu ermöglichen.

Value

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Zeichenfolgenwert des Elements abgerufen.

Value

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der string Wert des Elements abgerufen.

(Geerbt von XPathItem)
ValueAsBoolean

Ruft den Wert des aktuellen Knotens als ein Boolean.

ValueAsDateTime

Ruft den Wert des aktuellen Knotens als ein DateTime.

ValueAsDouble

Ruft den Wert des aktuellen Knotens als ein Double.

ValueAsInt

Ruft den Wert des aktuellen Knotens als ein Int32.

ValueAsLong

Ruft den Wert des aktuellen Knotens als ein Int64.

ValueType

Ruft .NET Type des aktuellen Knotens ab.

XmlLang

Ruft den xml:lang Bereich für den aktuellen Knoten ab.

XmlType

Ruft die XmlSchemaType Informationen für den aktuellen Knoten ab.

Methoden

Name Beschreibung
AppendChild()

Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines oder mehrerer neuer untergeordneter Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens verwendet wird.

AppendChild(String)

Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der angegebenen XML-Datenzeichenfolge.

AppendChild(XmlReader)

Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.

AppendChild(XPathNavigator)

Erstellt einen neuen untergeordneten Knoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der Knoten im XPathNavigator angegebenen.

AppendChildElement(String, String, String, String)

Erstellt einen neuen untergeordneten Elementknoten am Ende der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe des Namespacepräfixes, des lokalen Namens und des Namespace-URI, der mit dem angegebenen Wert angegeben ist.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Überprüft, ob die XML-Daten in der XPathNavigator bereitgestellten XML-Schemadefinitionssprache (XSD) entsprechen.

Clone()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine neue XPathNavigator Position am selben Knoten wie dieser XPathNavigatorerstellt.

ComparePosition(XPathNavigator)

Vergleicht die Position des Aktuellen XPathNavigator mit der Position des XPathNavigator angegebenen Elements.

Compile(String)

Kompiliert eine Zeichenfolge, die einen XPath-Ausdruck darstellt, und gibt ein XPathExpression Objekt zurück.

CreateAttribute(String, String, String, String)

Erstellt einen Attributknoten auf dem aktuellen Elementknoten mithilfe des Namespacepräfixes, des lokalen Namens und des Namespace-URI, der mit dem angegebenen Wert angegeben ist.

CreateAttributes()

Gibt ein XmlWriter Objekt zurück, das zum Erstellen neuer Attribute für das aktuelle Element verwendet wird.

CreateNavigator()

Gibt eine Kopie der .XPathNavigator

DeleteRange(XPathNavigator)

Löscht einen Bereich gleichgeordneter Knoten vom aktuellen Knoten zum angegebenen Knoten.

DeleteSelf()

Löscht den aktuellen Knoten und seine untergeordneten Knoten.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
Evaluate(String, IXmlNamespaceResolver)

Wertet den angegebenen XPath-Ausdruck aus und gibt das typierte Ergebnis zurück, wobei das IXmlNamespaceResolver angegebene Objekt zum Auflösen von Namespacepräfixen im XPath-Ausdruck verwendet wird.

Evaluate(String)

Wertet den angegebenen XPath-Ausdruck aus und gibt das eingegebene Ergebnis zurück.

Evaluate(XPathExpression, XPathNodeIterator)

Verwendet den angegebenen Kontext, um das XPathExpressionErgebnis auszuwerten und das eingegebene Ergebnis zurückzugeben.

Evaluate(XPathExpression)

Wertet das XPathExpression eingegebene Ergebnis aus und gibt es zurück.

GetAttribute(String, String)

Ruft den Wert des Attributs mit dem angegebenen lokalen Namen und Namespace-URI ab.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetNamespace(String)

Gibt den Wert des Namespaceknotens zurück, der dem angegebenen lokalen Namen entspricht.

GetNamespacesInScope(XmlNamespaceScope)

Gibt die Namespaces im Gültigkeitsbereich des aktuellen Knotens zurück.

GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
InsertAfter()

Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines neuen gleichgeordneten Knotens nach dem aktuell ausgewählten Knoten verwendet wird.

InsertAfter(String)

Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe der angegebenen XML-Zeichenfolge.

InsertAfter(XmlReader)

Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.

InsertAfter(XPathNavigator)

Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe der Knoten im XPathNavigator angegebenen Objekt.

InsertBefore()

Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines neuen gleichgeordneten Knotens vor dem aktuell ausgewählten Knoten verwendet wird.

InsertBefore(String)

Erstellt einen neuen gleichgeordneten Knoten vor dem aktuell ausgewählten Knoten mithilfe der angegebenen XML-Zeichenfolge.

InsertBefore(XmlReader)

Erstellt einen neuen gleichgeordneten Knoten vor dem aktuell ausgewählten Knoten mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.

InsertBefore(XPathNavigator)

Erstellt einen neuen gleichgeordneten Knoten vor dem aktuell ausgewählten Knoten mithilfe der Knoten im XPathNavigator angegebenen.

InsertElementAfter(String, String, String, String)

Erstellt ein neues gleichgeordnetes Element nach dem aktuellen Knoten unter Verwendung des Namespacepräfixes, des lokalen Namens und des namespace-URI, der mit dem angegebenen Wert angegeben ist.

InsertElementBefore(String, String, String, String)

Erstellt ein neues gleichgeordnetes Element vor dem aktuellen Knoten unter Verwendung des Namespacepräfixes, des lokalen Namens und des Namespace-URI, der mit dem angegebenen Wert angegeben ist.

IsDescendant(XPathNavigator)

Bestimmt, ob es sich bei dem angegebenen Wert XPathNavigator um ein untergeordnetes Element des aktuellen XPathNavigatorTyps handelt.

IsSamePosition(XPathNavigator)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, bestimmt, ob sich der Aktuelle XPathNavigator an derselben Position wie der angegebene XPathNavigatorBefindet.

LookupNamespace(String)

Ruft den Namespace-URI für das angegebene Präfix ab.

LookupPrefix(String)

Ruft das Präfix ab, das für den angegebenen Namespace-URI deklariert ist.

Matches(String)

Bestimmt, ob der aktuelle Knoten dem angegebenen XPath-Ausdruck entspricht.

Matches(XPathExpression)

Bestimmt, ob der aktuelle Knoten mit dem angegebenen XPathExpressionKnoten übereinstimmt.

MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
MoveTo(XPathNavigator)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XPathNavigator Position wie die angegebene verschoben XPathNavigator.

MoveToAttribute(String, String)

Verschiebt das XPathNavigator Attribut mit dem übereinstimmenden lokalen Namen und Namespace-URI.

MoveToChild(String, String)

Verschiebt den XPathNavigator untergeordneten Knoten mit dem angegebenen lokalen Namen und namespace-URI.

MoveToChild(XPathNodeType)

Verschiebt den untergeordneten XPathNavigator Knoten des XPathNodeType angegebenen Knotens.

MoveToFirst()

Verschiebt den XPathNavigator zum ersten Geschwisterknoten des aktuellen Knotens.

MoveToFirstAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das XPathNavigator erste Attribut des aktuellen Knotens verschoben.

MoveToFirstChild()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der XPathNavigator wechselt zum ersten untergeordneten Knoten des aktuellen Knotens.

MoveToFirstNamespace()

Verschiebt den XPathNavigator ersten Namespaceknoten des aktuellen Knotens.

MoveToFirstNamespace(XPathNamespaceScope)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird der XPathNavigator Wert auf den ersten Namespaceknoten verschoben, der dem XPathNamespaceScope angegebenen Entspricht.

MoveToFollowing(String, String, XPathNavigator)

Verschiebt das XPathNavigator Element mit dem angegebenen lokalen Namen und namespace-URI in die angegebene Grenze in der Dokumentreihenfolge.

MoveToFollowing(String, String)

Verschiebt das XPathNavigator Element mit dem lokalen Namen und dem Namespace-URI, der in der Dokumentreihenfolge angegeben ist.

MoveToFollowing(XPathNodeType, XPathNavigator)

Verschiebt das XPathNavigator folgende Element des XPathNodeType angegebenen Elements in die angegebene Begrenzungsreihenfolge.

MoveToFollowing(XPathNodeType)

Verschiebt das XPathNavigator folgende Element der XPathNodeType angegebenen Dokumentreihenfolge.

MoveToId(String)

Wenn eine abgeleitete Klasse überschrieben wird, wechselt zu dem Knoten mit einem Attribut vom Typ ID , dessen Wert mit dem angegebenen StringWert übereinstimmt.

MoveToNamespace(String)

Verschiebt den XPathNavigator Namespaceknoten mit dem angegebenen Namespacepräfix.

MoveToNext()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der XPathNavigator Nächste gleichgeordnete Knoten des aktuellen Knotens verschoben.

MoveToNext(String, String)

Verschiebt den XPathNavigator nächsten gleichgeordneten Knoten mit dem angegebenen lokalen Namen und namespace-URI.

MoveToNext(XPathNodeType)

Verschiebt den XPathNavigator knoten zum nächsten gleichgeordneten Knoten des aktuellen Knotens, der mit dem XPathNodeType angegebenen Knoten übereinstimmt.

MoveToNextAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das XPathNavigator Nächste Attribut verschoben.

MoveToNextNamespace()

Verschiebt den XPathNavigator Knoten zum nächsten Namespaceknoten.

MoveToNextNamespace(XPathNamespaceScope)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der XPathNavigator nächste Namespaceknoten verschoben, der dem XPathNamespaceScope angegebenen entspricht.

MoveToParent()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der XPathNavigator wechselt zum übergeordneten Knoten des aktuellen Knotens.

MoveToPrevious()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der XPathNavigator vorherige gleichgeordnete Knoten des aktuellen Knotens verschoben.

MoveToRoot()

Verschiebt den XPathNavigator Stammknoten, zu dem der aktuelle Knoten gehört.

PrependChild()

Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines neuen untergeordneten Knotens am Anfang der Liste der untergeordneten Knoten des aktuellen Knotens verwendet wird.

PrependChild(String)

Erstellt einen neuen untergeordneten Knoten am Anfang der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der angegebenen XML-Zeichenfolge.

PrependChild(XmlReader)

Erstellt einen neuen untergeordneten Knoten am Anfang der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.

PrependChild(XPathNavigator)

Erstellt einen neuen untergeordneten Knoten am Anfang der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe der Knoten im XPathNavigator angegebenen Objekt.

PrependChildElement(String, String, String, String)

Erstellt ein neues untergeordnetes Element am Anfang der Liste der untergeordneten Knoten des aktuellen Knotens mithilfe des Namespacepräfixes, des lokalen Namens und des Namespace-URI, der mit dem angegebenen Wert angegeben ist.

ReadSubtree()

Gibt ein XmlReader Objekt zurück, das den aktuellen Knoten und seine untergeordneten Knoten enthält.

ReplaceRange(XPathNavigator)

Ersetzt einen Bereich gleichgeordneter Knoten vom aktuellen Knoten bis zum angegebenen Knoten.

ReplaceSelf(String)

Ersetzt den aktuellen Knoten durch den Inhalt der angegebenen Zeichenfolge.

ReplaceSelf(XmlReader)

Ersetzt den aktuellen Knoten durch den Inhalt des XmlReader angegebenen Objekts.

ReplaceSelf(XPathNavigator)

Ersetzt den aktuellen Knoten durch den Inhalt des XPathNavigator angegebenen Objekts.

Select(String, IXmlNamespaceResolver)

Wählt einen Knotensatz mithilfe des angegebenen XPath-Ausdrucks mit dem IXmlNamespaceResolver angegebenen Objekt aus, um Namespacepräfixe aufzulösen.

Select(String)

Wählt einen Knotensatz mithilfe des angegebenen XPath-Ausdrucks aus.

Select(XPathExpression)

Wählt einen Knotensatz mithilfe des angegebenen XPathExpressionKnotens aus.

SelectAncestors(String, String, Boolean)

Wählt alle Vorgängerknoten des aktuellen Knotens mit dem angegebenen lokalen Namen und Namespace-URI aus.

SelectAncestors(XPathNodeType, Boolean)

Wählt alle Vorgängerknoten des aktuellen Knotens mit einem übereinstimmenden Knoten XPathNodeTypeaus.

SelectChildren(String, String)

Wählt alle untergeordneten Knoten des aktuellen Knotens aus, für die der lokale Name und der Namespace-URI angegeben sind.

SelectChildren(XPathNodeType)

Wählt alle untergeordneten Knoten des aktuellen Knotens mit dem übereinstimmenden Knoten XPathNodeTypeaus.

SelectDescendants(String, String, Boolean)

Wählt alle untergeordneten Knoten des aktuellen Knotens mit dem lokalen Namen und dem angegebenen Namespace-URI aus.

SelectDescendants(XPathNodeType, Boolean)

Wählt alle untergeordneten Knoten des aktuellen Knotens mit einem übereinstimmenden Knoten XPathNodeTypeaus.

SelectSingleNode(String, IXmlNamespaceResolver)

Wählt einen einzelnen Knoten im XPathNavigator Objekt mithilfe der angegebenen XPath-Abfrage mit dem IXmlNamespaceResolver angegebenen Objekt aus, um Namespacepräfixe aufzulösen.

SelectSingleNode(String)

Wählt einen einzelnen Knoten in der XPathNavigator angegebenen XPath-Abfrage aus.

SelectSingleNode(XPathExpression)

Wählt einen einzelnen Knoten im XPathNavigator angegebenen XPathExpression Objekt aus.

SetTypedValue(Object)

Legt den typierten Wert des aktuellen Knotens fest.

SetValue(String)

Legt den Wert des aktuellen Knotens fest.

ToString()

Ruft den Textwert des aktuellen Knotens ab.

ValueAs(Type, IXmlNamespaceResolver)

Ruft den Wert des aktuellen Knotens wie angegeben Type ab, wobei das IXmlNamespaceResolver angegebene Objekt zum Auflösen von Namespacepräfixen verwendet wird.

ValueAs(Type)

Gibt den Wert des Elements als angegebenen Typ zurück.

(Geerbt von XPathItem)
WriteSubtree(XmlWriter)

Streamt den aktuellen Knoten und seine untergeordneten Knoten an das XmlWriter angegebene Objekt.

Explizite Schnittstellenimplementierungen

Name Beschreibung
ICloneable.Clone()

Erstellt eine neue Kopie des XPathNavigator Objekts.

Gilt für:

Weitere Informationen