XPathNavigator Klasa

Definicja

Udostępnia model kursora do nawigowania i edytowania danych XML.

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
Dziedziczenie
XPathNavigator
Dziedziczenie
XPathNavigator
Pochodne
Implementuje

Uwagi

Klasa XPathNavigator w System.Xml.XPath przestrzeni nazw jest abstrakcyjną klasą, która definiuje model kursora do nawigowania i edytowania elementów informacji XML jako wystąpień modelu danych XQuery 1.0 i XPath 2.0.

Obiekt XPathNavigator jest tworzony na podstawie klasy, która implementuje interfejs, IXPathNavigable taki jak XPathDocument klasy i XmlDocument . XPathNavigator obiekty utworzone przez XPathDocument obiekty są tylko do odczytu, podczas gdy XPathNavigator obiekty utworzone przez XmlDocument obiekty mogą być edytowane. XPathNavigator Stan tylko do odczytu lub edytowalny obiektu jest określany przy użyciu CanEdit właściwości XPathNavigator klasy .

Aby uzyskać więcej informacji na temat przetwarzania danych XML przy użyciu modelu danych XPath, zobacz temat Przetwarzanie danych XML przy użyciu modelu danych XPath .

Ważne

Wyjątki zgłaszane w wyniku użycia XPathNavigator klasy, takiej jak XPathException klasa, mogą zawierać informacje poufne, które nie powinny być widoczne w niezaufanych scenariuszach. Wyjątki powinny być prawidłowo obsługiwane, aby te poufne informacje nie były widoczne w niezaufanych scenariuszach.

Uwagi dotyczące implementowania

Podczas dziedziczenia XPathNavigator z klasy należy zastąpić następujące elementy członkowskie:

Konstruktory

XPathNavigator()

Inicjuje nowe wystąpienie klasy XPathNavigator.

Właściwości

BaseURI

Po zastąpieniu w klasie pochodnej pobiera podstawowy identyfikator URI bieżącego węzła.

CanEdit

Pobiera wartość wskazującą, czy XPathNavigator można edytować bazowe dane XML.

HasAttributes

Pobiera wartość wskazującą, czy bieżący węzeł ma jakiekolwiek atrybuty.

HasChildren

Pobiera wartość wskazującą, czy bieżący węzeł ma jakiekolwiek węzły podrzędne.

InnerXml

Pobiera lub ustawia znaczniki reprezentujące węzły podrzędne bieżącego węzła.

IsEmptyElement

Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżący węzeł jest pustym elementem bez tagu elementu końcowego.

IsNode

Pobiera wartość wskazującą, czy bieżący węzeł reprezentuje węzeł XPath.

LocalName

Po zastąpieniu w klasie pochodnej pobiera Name bieżący węzeł bez żadnego prefiksu przestrzeni nazw.

Name

Po zastąpieniu w klasie pochodnej pobiera kwalifikowaną nazwę bieżącego węzła.

NamespaceURI

Po zastąpieniu w klasie pochodnej pobiera identyfikator URI przestrzeni nazw bieżącego węzła.

NameTable

Po przesłonięciu w klasie pochodnej pobiera XmlNameTable wartość XPathNavigator.

NavigatorComparer

Pobiera element IEqualityComparer używany do porównywania XPathNavigator równości obiektów.

NodeType

Po przesłonięciu w klasie pochodnej pobiera XPathNodeType bieżący węzeł.

OuterXml

Pobiera lub ustawia znaczniki reprezentujące tagi otwierania i zamykania bieżącego węzła i jego węzłów podrzędnych.

Prefix

Po zastąpieniu w klasie pochodnej pobiera prefiks przestrzeni nazw skojarzony z bieżącym węzłem.

SchemaInfo

Pobiera informacje o schemacie, które zostały przypisane do bieżącego węzła w wyniku weryfikacji schematu.

TypedValue

Pobiera bieżący węzeł jako obiekt skrzynkowy najbardziej odpowiedniego typu .NET.

UnderlyingObject

Używane przez XPathNavigator implementacje, które zapewniają "zwirtualizowany" widok XML w magazynie, aby zapewnić dostęp do bazowych obiektów.

Value

Po przesłonięciu w klasie pochodnej pobiera wartość ciągu elementu.

Value

Po zastąpieniu w klasie pochodnej pobiera string wartość elementu.

(Odziedziczone po XPathItem)
ValueAsBoolean

Pobiera wartość bieżącego węzła jako Boolean.

ValueAsDateTime

Pobiera wartość bieżącego węzła jako DateTime.

ValueAsDouble

Pobiera wartość bieżącego węzła jako Double.

ValueAsInt

Pobiera wartość bieżącego węzła jako .Int32

ValueAsLong

Pobiera wartość bieżącego węzła jako .Int64

ValueType

Pobiera platformę .NET Type bieżącego węzła.

XmlLang

xml:lang Pobiera zakres bieżącego węzła.

XmlType

XmlSchemaType Pobiera informacje dla bieżącego węzła.

XmlType

Po zastąpieniu w klasie pochodnej pobiera element XmlSchemaType dla elementu.

(Odziedziczone po XPathItem)

Metody

AppendChild()

XmlWriter Zwraca obiekt używany do tworzenia co najmniej jednego nowego węzła podrzędnego na końcu listy węzłów podrzędnych bieżącego węzła.

AppendChild(String)

Tworzy nowy węzeł podrzędny na końcu listy węzłów podrzędnych bieżącego węzła przy użyciu określonego ciągu danych XML.

AppendChild(XmlReader)

Tworzy nowy węzeł podrzędny na końcu listy węzłów podrzędnych bieżącego węzła przy użyciu zawartości XML określonego XmlReader obiektu.

AppendChild(XPathNavigator)

Tworzy nowy węzeł podrzędny na końcu listy węzłów podrzędnych bieżącego węzła przy użyciu węzłów w określonym.XPathNavigator

AppendChildElement(String, String, String, String)

Tworzy nowy węzeł elementu podrzędnego na końcu listy węzłów podrzędnych bieżącego węzła przy użyciu prefiksu przestrzeni nazw, nazwy lokalnej i identyfikatora URI przestrzeni nazw określonej z określoną wartością.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Sprawdza, czy dane XML w podanym XPathNavigator schemacie xml schema definition language (XSD) są zgodne.

Clone()

Po przesłonięciu w klasie pochodnej tworzy nowy XPathNavigator węzeł umieszczony w tym samym węźle co ten XPathNavigatorelement .

ComparePosition(XPathNavigator)

Porównuje położenie bieżącego XPathNavigator elementu z pozycją określonego XPathNavigator .

Compile(String)

Kompiluje ciąg reprezentujący wyrażenie XPath i zwraca XPathExpression obiekt.

CreateAttribute(String, String, String, String)

Tworzy węzeł atrybutu w bieżącym węźle elementu przy użyciu prefiksu przestrzeni nazw, lokalnego identyfikatora URI i przestrzeni nazw określonej z określoną wartością.

CreateAttributes()

XmlWriter Zwraca obiekt używany do tworzenia nowych atrybutów w bieżącym elemencie.

CreateNavigator()

Zwraca kopię elementu XPathNavigator.

DeleteRange(XPathNavigator)

Usuwa zakres węzłów równorzędnych z bieżącego węzła do określonego węzła.

DeleteSelf()

Usuwa bieżący węzeł i jego węzły podrzędne.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
Evaluate(String)

Oblicza określone wyrażenie XPath i zwraca wpisany wynik.

Evaluate(String, IXmlNamespaceResolver)

Oblicza określone wyrażenie XPath i zwraca wpisany wynik, używając określonego IXmlNamespaceResolver obiektu do rozpoznawania prefiksów przestrzeni nazw w wyrażeniu XPath.

Evaluate(XPathExpression)

Oblicza element XPathExpression i zwraca wpisany wynik.

Evaluate(XPathExpression, XPathNodeIterator)

Używa podanego kontekstu, aby ocenić XPathExpressionparametr i zwraca typowany wynik.

GetAttribute(String, String)

Pobiera wartość atrybutu o określonej lokalnej nazwie i identyfikatorze URI przestrzeni nazw.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetNamespace(String)

Zwraca wartość węzła przestrzeni nazw odpowiadającą określonej nazwie lokalnej.

GetNamespacesInScope(XmlNamespaceScope)

Zwraca przestrzenie nazw w zakresie bieżącego węzła.

GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
InsertAfter()

XmlWriter Zwraca obiekt używany do tworzenia nowego węzła równorzędnego po aktualnie wybranym węźle.

InsertAfter(String)

Tworzy nowy węzeł równorzędny po aktualnie wybranym węźle przy użyciu określonego ciągu XML.

InsertAfter(XmlReader)

Tworzy nowy węzeł równorzędny po aktualnie wybranym węźle przy użyciu zawartości XML określonego XmlReader obiektu.

InsertAfter(XPathNavigator)

Tworzy nowy węzeł równorzędny po aktualnie wybranym węźle przy użyciu węzłów w XPathNavigator określonym obiekcie.

InsertBefore()

XmlWriter Zwraca obiekt używany do tworzenia nowego węzła równorzędnego przed aktualnie wybranym węzłem.

InsertBefore(String)

Tworzy nowy węzeł równorzędny przed aktualnie wybranym węzłem przy użyciu określonego ciągu XML.

InsertBefore(XmlReader)

Tworzy nowy węzeł równorzędny przed aktualnie wybranym węzłem przy użyciu zawartości XML określonego XmlReader obiektu.

InsertBefore(XPathNavigator)

Tworzy nowy węzeł równorzędny przed aktualnie wybranym węzłem przy użyciu węzłów w XPathNavigator określonym.

InsertElementAfter(String, String, String, String)

Tworzy nowy element równorzędny po bieżącym węźle przy użyciu prefiksu przestrzeni nazw, nazwy lokalnej i określonego identyfikatora URI przestrzeni nazw z określoną wartością.

InsertElementBefore(String, String, String, String)

Tworzy nowy element równorzędny przed bieżącym węzłem przy użyciu prefiksu przestrzeni nazw, nazwy lokalnej i określonego identyfikatora URI przestrzeni nazw z określoną wartością.

IsDescendant(XPathNavigator)

Określa, czy określony XPathNavigator element jest elementem podrzędnym bieżącego XPathNavigatorelementu .

IsSamePosition(XPathNavigator)

Po przesłonięciu w klasie pochodnej określa, czy bieżący XPathNavigator jest w tej samej pozycji co określony XPathNavigator.

LookupNamespace(String)

Pobiera identyfikator URI przestrzeni nazw dla określonego prefiksu.

LookupPrefix(String)

Pobiera prefiks zadeklarowany dla określonego identyfikatora URI przestrzeni nazw.

Matches(String)

Określa, czy bieżący węzeł jest zgodny z określonym wyrażeniem XPath.

Matches(XPathExpression)

Określa, czy bieżący węzeł jest zgodny z określonym XPathExpressionelementem .

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MoveTo(XPathNavigator)

Po przesłonięciu w klasie pochodnej przenosi element XPathNavigator do tej samej pozycji co określony XPathNavigatorelement .

MoveToAttribute(String, String)

Przenosi element XPathNavigator do atrybutu z pasującą lokalną nazwą i identyfikatorem URI przestrzeni nazw.

MoveToChild(String, String)

Przenosi element XPathNavigator do węzła podrzędnego z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw.

MoveToChild(XPathNodeType)

Przenosi element XPathNavigator do węzła podrzędnego określonego XPathNodeType .

MoveToFirst()

Przenosi element XPathNavigator do pierwszego węzła równorzędnego bieżącego węzła.

MoveToFirstAttribute()

Gdy zastąpisz klasę pochodną, przenosi element XPathNavigator do pierwszego atrybutu bieżącego węzła.

MoveToFirstChild()

Gdy zastąpisz klasę pochodną, przenosi element XPathNavigator do pierwszego węzła podrzędnego bieżącego węzła.

MoveToFirstNamespace()

Przenosi element XPathNavigator do pierwszego węzła przestrzeni nazw bieżącego węzła.

MoveToFirstNamespace(XPathNamespaceScope)

Po zastąpieniu w klasie pochodnej przenosi element XPathNavigator do pierwszego węzła przestrzeni nazw zgodnego z określoną wartością XPathNamespaceScope .

MoveToFollowing(String, String)

Przenosi element XPathNavigator do elementu z lokalną nazwą i identyfikatorem URI przestrzeni nazw określonym w kolejności dokumentu.

MoveToFollowing(String, String, XPathNavigator)

Przenosi element XPathNavigator do elementu z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw do określonej granicy w kolejności dokumentu.

MoveToFollowing(XPathNodeType)

Przenosi element XPathNavigator do następującego elementu określonego XPathNodeType w kolejności dokumentu.

MoveToFollowing(XPathNodeType, XPathNavigator)

Przenosi element XPathNavigator do następującego XPathNodeType elementu określonego, do określonej granicy w kolejności dokumentu.

MoveToId(String)

Po przesłonięciu w klasie pochodnej przechodzi do węzła, który ma atrybut typu ID , którego wartość jest zgodna z określoną wartością String.

MoveToNamespace(String)

Przenosi element XPathNavigator do węzła przestrzeni nazw z określonym prefiksem przestrzeni nazw.

MoveToNext()

Gdy zastąpisz klasę pochodną, przenosi element XPathNavigator do następnego węzła równorzędnego bieżącego węzła.

MoveToNext(String, String)

Przenosi element XPathNavigator do następnego węzła równorzędnego z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw.

MoveToNext(XPathNodeType)

Przenosi element XPathNavigator do następnego węzła równorzędnego bieżącego węzła zgodnego z określoną wartością XPathNodeType .

MoveToNextAttribute()

Gdy zastąpisz klasę pochodną, przenosi element XPathNavigator do następnego atrybutu.

MoveToNextNamespace()

Przenosi element XPathNavigator do następnego węzła przestrzeni nazw.

MoveToNextNamespace(XPathNamespaceScope)

Po zastąpieniu w klasie pochodnej przenosi element XPathNavigator do następnego węzła przestrzeni nazw zgodnego z określoną wartością XPathNamespaceScope .

MoveToParent()

Gdy zastąpisz klasę pochodną, przenosi element XPathNavigator do węzła nadrzędnego bieżącego węzła.

MoveToPrevious()

Po zastąpieniu w klasie pochodnej przenosi element XPathNavigator do poprzedniego węzła równorzędnego bieżącego węzła.

MoveToRoot()

Przenosi węzeł XPathNavigator główny, do którego należy bieżący węzeł.

PrependChild()

XmlWriter Zwraca obiekt używany do utworzenia nowego węzła podrzędnego na początku listy węzłów podrzędnych bieżącego węzła.

PrependChild(String)

Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu określonego ciągu XML.

PrependChild(XmlReader)

Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu zawartości XML określonego XmlReader obiektu.

PrependChild(XPathNavigator)

Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu węzłów w XPathNavigator określonym obiekcie.

PrependChildElement(String, String, String, String)

Tworzy nowy element podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu prefiksu przestrzeni nazw, nazwy lokalnej i identyfikatora URI przestrzeni nazw określonej z określoną wartością.

ReadSubtree()

XmlReader Zwraca obiekt zawierający bieżący węzeł i jego węzły podrzędne.

ReplaceRange(XPathNavigator)

Zastępuje zakres węzłów równorzędnych z bieżącego węzła do określonego węzła.

ReplaceSelf(String)

Zastępuje bieżący węzeł zawartością określonego ciągu.

ReplaceSelf(XmlReader)

Zastępuje bieżący węzeł zawartością określonego XmlReader obiektu.

ReplaceSelf(XPathNavigator)

Zastępuje bieżący węzeł zawartością określonego XPathNavigator obiektu.

Select(String)

Wybiera zestaw węzłów przy użyciu określonego wyrażenia XPath.

Select(String, IXmlNamespaceResolver)

Wybiera zestaw węzłów przy użyciu określonego wyrażenia XPath z określonym obiektem IXmlNamespaceResolver w celu rozpoznania prefiksów przestrzeni nazw.

Select(XPathExpression)

Wybiera zestaw węzłów przy użyciu określonego XPathExpressionelementu .

SelectAncestors(String, String, Boolean)

Wybiera wszystkie węzły nadrzędne bieżącego węzła z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw.

SelectAncestors(XPathNodeType, Boolean)

Wybiera wszystkie węzły nadrzędne bieżącego węzła, które mają pasujący XPathNodeTypeelement .

SelectChildren(String, String)

Wybiera wszystkie węzły podrzędne bieżącego węzła z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw.

SelectChildren(XPathNodeType)

Wybiera wszystkie węzły podrzędne bieżącego węzła, które mają pasujący element XPathNodeType.

SelectDescendants(String, String, Boolean)

Wybiera wszystkie węzły podrzędne bieżącego węzła z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw.

SelectDescendants(XPathNodeType, Boolean)

Wybiera wszystkie węzły podrzędne bieżącego węzła, które mają pasujący XPathNodeTypeelement .

SelectSingleNode(String)

Wybiera jeden węzeł w XPathNavigator obiekcie przy użyciu określonego zapytania XPath.

SelectSingleNode(String, IXmlNamespaceResolver)

Wybiera jeden węzeł w XPathNavigator obiekcie przy użyciu określonego zapytania XPath z określonym obiektem IXmlNamespaceResolver w celu rozpoznania prefiksów przestrzeni nazw.

SelectSingleNode(XPathExpression)

Wybiera jeden węzeł w XPathNavigator obiekcie przy użyciu określonego XPathExpression obiektu.

SetTypedValue(Object)

Ustawia typizowane wartości bieżącego węzła.

SetValue(String)

Ustawia wartość bieżącego węzła.

ToString()

Pobiera wartość tekstowa bieżącego węzła.

ValueAs(Type)

Zwraca wartość elementu jako określony typ.

(Odziedziczone po XPathItem)
ValueAs(Type, IXmlNamespaceResolver)

Pobiera wartość bieżącego Type węzła jako określoną, używając określonego IXmlNamespaceResolver obiektu do rozpoznawania prefiksów przestrzeni nazw.

WriteSubtree(XmlWriter)

Przesyła strumieniowo bieżący węzeł i jego węzły podrzędne do określonego XmlWriter obiektu.

Jawne implementacje interfejsu

ICloneable.Clone()

Tworzy nową kopię XPathNavigator obiektu.

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Zobacz też