Teilen über


XPathNavigator Klasse

Definition

Stellt ein Cursormodell für die Navigation und Bearbeitung 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 IXPathNavigable -Schnittstelle implementiert, z. B. die XPathDocument Klassen und XmlDocument . 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 zur Verarbeitung von XML-Daten mithilfe des XPath-Datenmodells finden Sie im Thema Verarbeiten von XML-Daten mithilfe des XPath-Datenmodells .

Wichtig

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

XPathNavigator()

Initialisiert eine neue Instanz der XPathNavigator-Klasse.

Eigenschaften

BaseURI

Ruft beim Überschreiben in einer abgeleiteten Klasse den Basis-URI des aktuellen Knotens ab.

CanEdit

Ruft einen Wert ab, der angibt, ob der XPathNavigator die zugrundeliegenden XML-Daten bearbeiten kann.

HasAttributes

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

HasChildren

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

InnerXml

Ruft das Markup ab, das die untergeordneten Knoten des aktuellen Knotens darstellt, oder legt dieses fest.

IsEmptyElement

Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob der aktuelle Knoten ein leeres Element ohne Endtag ist.

IsNode

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

LocalName

Ruft beim Überschreiben in einer abgeleiteten Klasse den Name des aktuellen Knotens ohne Namespacepräfix ab.

Name

Ruft beim Überschreiben in einer abgeleiteten Klasse den qualifizierten Namen des aktuellen Knotens ab.

NamespaceURI

Ruft beim Überschreiben in einer abgeleiteten Klasse den Namespace-URI des aktuellen Knotens ab.

NameTable

Ruft beim Überschreiben in einer abgeleiteten Klasse die XmlNameTable für den XPathNavigator ab.

NavigatorComparer

Ruft einen IEqualityComparer ab, der für Vergleiche von XPathNavigator-Objekten auf Gleichheit verwendet wird.

NodeType

Ruft beim Überschreiben in einer abgeleiteten Klasse den XPathNodeType des aktuellen Knotens ab.

OuterXml

Ruft das Markup ab, das die Anfangs- und Endtags des aktuellen Knotens und dessen untergeordneter Knoten darstellt, oder legt dieses fest.

Prefix

Ruft beim Überschreiben in einer abgeleiteten Klasse das dem aktuellen Knoten zugeordnete Namespacepräfix ab.

SchemaInfo

Ruft die Schemainformationen ab, die dem aktuellen Knoten nach der Schemavalidierung zugewiesen wurden.

TypedValue

Ruft den aktuellen Knoten als ein geschachteltes Objekt vom geeignetsten .NET-Typ ab.

UnderlyingObject

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

Value

Ruft beim Überschreiben in einer abgeleiteten Klasse den Zeichenfolgenwert des Elements ab.

Value

Ruft beim Überschreiben in einer abgeleiteten Klasse den string-Wert des Elements ab.

(Geerbt von XPathItem)
ValueAsBoolean

Ruft den Wert des aktuellen Knotens als Boolean ab.

ValueAsDateTime

Ruft den Wert des aktuellen Knotens als DateTime ab.

ValueAsDouble

Ruft den Wert des aktuellen Knotens als Double ab.

ValueAsInt

Ruft den Wert des aktuellen Knotens als Int32 ab.

ValueAsLong

Ruft den Wert des aktuellen Knotens als Int64 ab.

ValueType

Ruft den .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.

XmlType

Ruft beim Überschreiben in einer abgeleiteten Klasse den XmlSchemaType des Elements ab.

(Geerbt von XPathItem)

Methoden

AppendChild()

Gibt ein XmlWriter-Objekt zurück, mit dem am Ende der Liste mit untergeordneten Knoten des aktuellen Knotens ein oder mehrere neue untergeordnete Knoten erstellt werden können.

AppendChild(String)

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

AppendChild(XmlReader)

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

AppendChild(XPathNavigator)

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

AppendChildElement(String, String, String, String)

Erstellt am Ende der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Elementknoten mit dem angegebenen Wert. Dabei werden die angegebenen Werte für das Namespacepräfix, den lokalen Namen und den Namespace-URI verwendet.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Überprüft, ob die XML-Daten im XPathNavigator dem bereitgestellten XSD (XML Schema Definition Language)-Schema entsprechen.

Clone()

Erstellt beim Überschreiben in einer abgeleiteten Klasse einen neuen XPathNavigator, der auf demselben Knoten wie dieser XPathNavigator positioniert ist.

ComparePosition(XPathNavigator)

Vergleicht die Position des aktuellen XPathNavigator mit der Position des angegebenen XPathNavigator.

Compile(String)

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

CreateAttribute(String, String, String, String)

Erstellt auf dem aktuellen Knoten einen Attributknoten mit dem angegebenen Wert. Dabei werden die angegebenen Werte für das Namespacepräfix, den lokalen Namen und den Namespace-URI verwendet.

CreateAttributes()

Gibt ein XmlWriter-Objekt zurück, mit dem neue Attribute für das aktuelle Element erstellt werden können.

CreateNavigator()

Gibt eine Kopie des XPathNavigator zurück.

DeleteRange(XPathNavigator)

Löscht einen Bereich von nebengeordneten Knoten, vom aktuellen Knoten bis zum angegebenen Knoten.

DeleteSelf()

Löscht den aktuellen Knoten und dessen untergeordnete Knoten.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Evaluate(String)

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

Evaluate(String, IXmlNamespaceResolver)

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

Evaluate(XPathExpression)

Wertet den XPathExpression aus und gibt das typisierte Ergebnis zurück.

Evaluate(XPathExpression, XPathNodeIterator)

Verwendet den angegebenen Kontext für die Auswertung des XPathExpression und gibt das typisierte Ergebnis zurück.

GetAttribute(String, String)

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

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetNamespace(String)

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

GetNamespacesInScope(XmlNamespaceScope)

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

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InsertAfter()

Gibt ein XmlWriter-Objekt zurück, mit dem ein neuer nebengeordneter Knoten nach dem gegenwärtig ausgewählten Knoten erstellt werden kann.

InsertAfter(String)

Erstellt unter Verwendung der angegebenen XML-Zeichenfolge einen neuen nebengeordneten Knoten nach dem gegenwärtig ausgewählten Knoten.

InsertAfter(XmlReader)

Erstellt mit dem XML-Inhalt des angegebenen XmlReader-Objekts einen neuen nebengeordneten Knoten nach dem gegenwärtig ausgewählten Knoten.

InsertAfter(XPathNavigator)

Erstellt mithilfe der Knoten im XPathNavigator-Objekt einen neuen nebengeordneten Knoten nach dem gegenwärtig ausgewählten Knoten.

InsertBefore()

Gibt ein XmlWriter-Objekt zurück, mit dem ein neuer nebengeordneter Knoten vor dem gegenwärtig ausgewählten Knoten erstellt werden kann.

InsertBefore(String)

Erstellt unter Verwendung der angegebenen XML-Zeichenfolge einen neuen nebengeordneten Knoten vor dem gegenwärtig ausgewählten Knoten.

InsertBefore(XmlReader)

Erstellt mit dem XML-Inhalt des angegebenen XmlReader-Objekts einen neuen nebengeordneten Knoten vor dem gegenwärtig ausgewählten Knoten.

InsertBefore(XPathNavigator)

Erstellt mithilfe der Knoten im XPathNavigator einen neuen nebengeordneten Knoten vor dem gegenwärtig ausgewählten Knoten.

InsertElementAfter(String, String, String, String)

Erstellt nach dem aktuellen Knoten ein neues nebengeordnetes Element mit dem angegebenen Wert. Dabei werden die angegebenen Werte für das Namespacepräfix, den lokalen Namen und den Namespace-URI verwendet.

InsertElementBefore(String, String, String, String)

Erstellt vor dem aktuellen Knoten ein neues nebengeordnetes Element mit dem angegebenen Wert. Dabei werden die angegebenen Werte für das Namespacepräfix, den lokalen Namen und den Namespace-URI verwendet.

IsDescendant(XPathNavigator)

Bestimmt, ob der angegebene XPathNavigator ein Nachkomme des aktuellen XPathNavigator ist.

IsSamePosition(XPathNavigator)

Bestimmt beim Überschreiben in einer abgeleiteten Klasse, ob sich der aktuelle XPathNavigator an der gleichen Position wie der angegebene XPathNavigator befindet.

LookupNamespace(String)

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

LookupPrefix(String)

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

Matches(String)

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

Matches(XPathExpression)

Bestimmt, ob der aktuelle Knoten dem angegebenen XPathExpression entspricht.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MoveTo(XPathNavigator)

Verschiebt beim Überschrieben in einer abgeleiteten Klasse den XPathNavigator an die Position des angegebenen XPathNavigator.

MoveToAttribute(String, String)

Verschiebt den XPathNavigator zu dem Attribut mit dem entsprechenden lokalen Namen und Namespace-URI.

MoveToChild(String, String)

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

MoveToChild(XPathNodeType)

Verschiebt den XPathNavigator auf den untergeordneten Knoten vom angegebenen XPathNodeType.

MoveToFirst()

Positioniert den XPathNavigator auf den ersten dem aktuellen Knoten nebengeordneten Knoten.

MoveToFirstAttribute()

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf das erste Attribut des aktuellen Knotens.

MoveToFirstChild()

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf den ersten untergeordneten Knoten des aktuellen Knotens.

MoveToFirstNamespace()

Verschiebt den XPathNavigator auf den ersten Namespaceknoten des aktuellen Knotens.

MoveToFirstNamespace(XPathNamespaceScope)

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf den ersten Namespaceknoten, der dem angegebenen XPathNamespaceScope entspricht.

MoveToFollowing(String, String)

Verschiebt den XPathNavigator in Dokumentreihenfolge auf das Element mit dem angegebenen lokalen Namen und Namespace-URI.

MoveToFollowing(String, String, XPathNavigator)

Verschiebt den XPathNavigator in Dokumentreihenfolge bis zur angegebenen Begrenzung auf das Element mit dem angegebenen lokalen Namen und Namespace-URI.

MoveToFollowing(XPathNodeType)

Verschiebt den XPathNavigator auf das folgende Element vom angegebenen XPathNodeType in Dokumentreihenfolge.

MoveToFollowing(XPathNodeType, XPathNavigator)

Verschiebt den XPathNavigator in Dokumentreihenfolge bis zur angegebenen Begrenzung zum folgenden Element vom angegebenen XPathNodeType.

MoveToId(String)

Wechselt beim Überschreiben in einer abgeleiteten Klasse zu dem Knoten, der über ein Attribut vom Typ ID verfügt, dessen Wert mit dem angegebenen Stringübereinstimmt.

MoveToNamespace(String)

Verschiebt den XPathNavigator auf den Namespaceknoten mit dem angegebenen Namespacepräfix.

MoveToNext()

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf den nächsten nebengeordneten Knoten des aktuellen Knotens.

MoveToNext(String, String)

Verschiebt den XPathNavigator auf den nächsten nebengeordneten Knoten mit dem angegebenen lokalen Namen und Namespace-URI.

MoveToNext(XPathNodeType)

Verschiebt den XPathNavigator auf den nächsten nebengeordneten Knoten des aktuellen Knotens, der dem angegebenen XPathNodeType entspricht.

MoveToNextAttribute()

Verschiebt die Position des XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf das nächste Attribut.

MoveToNextNamespace()

Verschiebt den XPathNavigator zum nächsten Namespaceknoten.

MoveToNextNamespace(XPathNamespaceScope)

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf den nächsten Namespaceknoten, der dem angegebenen XPathNamespaceScope entspricht.

MoveToParent()

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf den übergeordneten Knoten des aktuellen Knotens.

MoveToPrevious()

Verschiebt den XPathNavigator beim Überschreiben in einer abgeleiteten Klasse auf den vorhergehenden nebengeordneten Knoten des aktuellen Knotens.

MoveToRoot()

Verschiebt die Position des XPathNavigator auf den Stammknoten, zu dem der aktuelle Knoten gehört.

PrependChild()

Gibt ein XmlWriter-Objekt zurück, mit dem am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens ein neuer untergeordneter Knoten erstellt werden kann.

PrependChild(String)

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

PrependChild(XmlReader)

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

PrependChild(XPathNavigator)

Erstellt unter Verwendung der Knoten im angegebenen XPathNavigator-Objekt am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neuen untergeordneten Knoten.

PrependChildElement(String, String, String, String)

Erstellt am Anfang der Liste mit untergeordneten Knoten des aktuellen Knotens einen neues untergeordnetes Element mit dem angegebenen Wert. Dabei werden die angegebenen Werte für das Namespacepräfix, den lokalen Namen und den Namespace-URI verwendet.

ReadSubtree()

Gibt ein XmlReader-Objekt zurück, das den aktuellen Knoten und dessen untergeordnete Knoten enthält.

ReplaceRange(XPathNavigator)

Ersetzt einen Bereich von nebengeordneten Knoten, vom aktuellen Knoten bis zum angegebenen Knoten.

ReplaceSelf(String)

Ersetzt den aktuellen Knoten mit dem Inhalt der angegebenen Zeichenfolge.

ReplaceSelf(XmlReader)

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

ReplaceSelf(XPathNavigator)

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

Select(String)

Wählt unter Verwendung des angegebenen XPath-Ausdrucks eine Knotengruppe aus.

Select(String, IXmlNamespaceResolver)

Wählt mit dem angegebenen XPath-Ausdruck eine Knotengruppe aus, wobei das angegebene IXmlNamespaceResolver-Objekt zum Auflösen von Namespacepräfixen verwendet wird.

Select(XPathExpression)

Wählt unter Verwendung der angegebenen XPathExpression eine Knotengruppe aus.

SelectAncestors(String, String, Boolean)

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

SelectAncestors(XPathNodeType, Boolean)

Wählt alle übergeordneten Knoten des aktuellen Knoten aus, die über einen übereinstimmenden XPathNodeType verfügen.

SelectChildren(String, String)

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

SelectChildren(XPathNodeType)

Wählt alle direkt untergeordneten Knoten des aktuellen Knotens mit dem entsprechenden XPathNodeType aus.

SelectDescendants(String, String, Boolean)

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

SelectDescendants(XPathNodeType, Boolean)

Wählt alle untergeordneten Knoten des aktuellen Knoten aus, die über einen übereinstimmenden XPathNodeType verfügen.

SelectSingleNode(String)

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

SelectSingleNode(String, IXmlNamespaceResolver)

Wählt mit der angegebenen XPath-Abfrage einen einzelnen Knoten im XPathNavigator-Objekt aus. Dabei wird das angegebene IXmlNamespaceResolver-Objekt zum Auflösen von Namespacepräfixen verwendet.

SelectSingleNode(XPathExpression)

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

SetTypedValue(Object)

Legt den typisierten Wert des aktuellen Knotens fest.

SetValue(String)

Legt den Wert des aktuellen Knotens fest.

ToString()

Ruft den Textwert des aktuellen Knotens ab.

ValueAs(Type)

Gibt den Wert des Elements mit dem angegebenen Typ zurück.

(Geerbt von XPathItem)
ValueAs(Type, IXmlNamespaceResolver)

Ruft den Wert des aktuellen Knotens mit dem angegebenen Type ab. Dabei wird das angegebene IXmlNamespaceResolver-Objekt zum Auflösen von Namespacepräfixen verwendet.

WriteSubtree(XmlWriter)

Übergibt den aktuellen Knoten und dessen untergeordnete Knoten als Stream an das angegebene XmlWriter-Objekt.

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Erstellt eine neue Kopie des XPathNavigator-Objekts.

Gilt für:

Weitere Informationen