XPathNavigator Sınıf

Tanım

XML verilerinde gezinmek ve verileri düzenlemek için bir imleç modeli sağlar.

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
Devralma
XPathNavigator
Devralma
XPathNavigator
Türetilmiş
Uygulamalar

Açıklamalar

XPathNavigator Ad alanında sınıfı, XML bilgi öğelerinde System.Xml.XPath XQuery 1.0 ve XPath 2.0 Veri Modeli örnekleri olarak gezinmek ve düzenlemek için imleç modelini tanımlayan soyut bir sınıftır.

nesnesiXPathNavigator, ve XmlDocument sınıfları gibi arabirimini uygulayan IXPathNavigable bir sınıftan XPathDocument oluşturulur. XPathNavigator nesneler tarafından XPathDocument oluşturulan nesneler salt okunurken XPathNavigator , nesneler tarafından XmlDocument oluşturulan nesneler düzenlenebilir. Bir XPathNavigator nesnenin salt okunur veya düzenlenebilir durumu sınıfın CanEditXPathNavigator özelliği kullanılarak belirlenir.

XPath veri modelini kullanarak XML verilerini işleme hakkında daha fazla bilgi için XPath Veri Modelini Kullanarak XML Verilerini İşleme konusuna bakın.

Önemli

sınıfı gibi XPathException sınıfın kullanılması XPathNavigator sonucunda ortaya çıkan özel durumlar, güvenilmeyen senaryolarda kullanıma sunulmaması gereken hassas bilgiler içerebilir. Bu hassas bilgilerin güvenilmeyen senaryolarda gösterilmemesi için özel durumlar düzgün bir şekilde işlenmelidir.

Uygulayanlara Notlar

sınıfından XPathNavigator devraldığınızda, aşağıdaki üyeleri geçersiz kılmanız gerekir:

Oluşturucular

XPathNavigator()

XPathNavigator sınıfının yeni bir örneğini başlatır.

Özellikler

BaseURI

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğüm için temel URI'yi alır.

CanEdit

öğesinin temel xml verilerini düzenleyip XPathNavigator düzenleyemeyeceğini belirten bir değer alır.

HasAttributes

Geçerli düğümün öznitelikleri olup olmadığını gösteren bir değer alır.

HasChildren

Geçerli düğümün alt düğüme sahip olup olmadığını gösteren bir değer alır.

InnerXml

Geçerli düğümün alt düğümlerini temsil eden işaretlemeyi alır veya ayarlar.

IsEmptyElement

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümün bitiş öğesi etiketi olmayan boş bir öğe olup olmadığını belirten bir değer alır.

IsNode

Geçerli düğümün bir XPath düğümünü temsil ettiğini gösteren bir değer alır.

LocalName

Türetilmiş bir sınıfta geçersiz kılındığında, herhangi bir ad alanı ön eki olmadan geçerli düğümün öğesini alır Name .

Name

Türetilmiş bir sınıfta geçersiz kılındığında geçerli düğümün tam adını alır.

NamespaceURI

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümün ad alanı URI'sini alır.

NameTable

Türetilmiş bir sınıfta geçersiz kılındığında, öğesinin alır XmlNameTableXPathNavigator.

NavigatorComparer

Nesnelerin eşitlik karşılaştırması için kullanılan bir IEqualityComparerXPathNavigator alır.

NodeType

Türetilmiş bir sınıfta geçersiz kılındığında geçerli düğümün alır XPathNodeType .

OuterXml

Geçerli düğümün ve alt düğümlerinin açma ve kapatma etiketlerini temsil eden işaretlemeyi alır veya ayarlar.

Prefix

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümle ilişkili ad alanı ön ekini alır.

SchemaInfo

Şema doğrulamasının bir sonucu olarak geçerli düğüme atanmış şema bilgilerini alır.

TypedValue

Geçerli düğümü en uygun .NET türünde kutulu nesne olarak alır.

UnderlyingObject

Temel alınan nesnelere erişim sağlamak için bir depo üzerinde "sanallaştırılmış" XML görünümü sağlayan uygulamalar tarafından XPathNavigator kullanılır.

Value

Türetilmiş bir sınıfta geçersiz kılındığında, öğenin dize değerini alır.

Value

Türetilmiş bir sınıfta geçersiz kılındığında öğenin değerini alır string .

(Devralındığı yer: XPathItem)
ValueAsBoolean

Geçerli düğümün değerini olarak Booleanalır.

ValueAsDateTime

Geçerli düğümün değerini olarak DateTimealır.

ValueAsDouble

Geçerli düğümün değerini olarak Doublealır.

ValueAsInt

Geçerli düğümün değerini olarak Int32alır.

ValueAsLong

Geçerli düğümün değerini olarak Int64alır.

ValueType

Geçerli düğümün .NET'ini Type alır.

XmlLang

Geçerli düğümün xml:lang kapsamını alır.

XmlType

Geçerli düğümün XmlSchemaType bilgilerini alır.

XmlType

Türetilmiş bir sınıfta geçersiz kılındığında, öğenin öğesini XmlSchemaType alır.

(Devralındığı yer: XPathItem)

Yöntemler

AppendChild()

Geçerli düğümün alt düğümleri listesinin sonunda bir veya daha fazla yeni alt düğüm oluşturmak için kullanılan bir XmlWriter nesneyi döndürür.

AppendChild(String)

Belirtilen XML veri dizesini kullanarak geçerli düğümün alt düğümleri listesinin sonunda yeni bir alt düğüm oluşturur.

AppendChild(XmlReader)

Belirtilen nesnenin XML içeriğini XmlReader kullanarak geçerli düğümün alt düğümleri listesinin sonunda yeni bir alt düğüm oluşturur.

AppendChild(XPathNavigator)

Belirtilen düğümlerdeki düğümleri kullanarak geçerli düğümün alt düğümleri listesinin sonunda yeni bir alt düğüm XPathNavigator oluşturur.

AppendChildElement(String, String, String, String)

Belirtilen değerle belirtilen ad alanı ön ekini, yerel adı ve ad alanı URI'sini kullanarak geçerli düğümün alt düğümleri listesinin sonunda yeni bir alt öğe düğümü oluşturur.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

içindeki XPathNavigator XML verilerinin sağlanan XML Şema tanım dili (XSD) şemasına uygun olduğunu doğrular.

Clone()

Türetilmiş bir sınıfta geçersiz kılındığında, bu XPathNavigatorile aynı düğümde konumlandırılmış yeni XPathNavigator bir oluşturur.

ComparePosition(XPathNavigator)

Geçerli XPathNavigator konumu belirtilen konumuyla XPathNavigator karşılaştırır.

Compile(String)

XPath ifadesini temsil eden bir dize derler ve bir XPathExpression nesnesi döndürür.

CreateAttribute(String, String, String, String)

Belirtilen değerle belirtilen ad alanı ön ekini, yerel adı ve ad alanı URI'sini kullanarak geçerli öğe düğümünde bir öznitelik düğümü oluşturur.

CreateAttributes()

Geçerli öğede yeni öznitelikler oluşturmak için kullanılan bir XmlWriter nesne döndürür.

CreateNavigator()

öğesinin XPathNavigatorbir kopyasını döndürür.

DeleteRange(XPathNavigator)

Geçerli düğümden belirtilen düğüme eşdüzey düğüm aralığını siler.

DeleteSelf()

Geçerli düğümü ve alt düğümlerini siler.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Evaluate(String)

Belirtilen XPath ifadesini değerlendirir ve yazılan sonucu döndürür.

Evaluate(String, IXmlNamespaceResolver)

Belirtilen XPath ifadesini değerlendirir ve XPath ifadesindeki ad alanı ön eklerini çözümlemek için belirtilen nesneyi kullanarak IXmlNamespaceResolver yazılan sonucu döndürür.

Evaluate(XPathExpression)

XPathExpression değerini değerlendirir ve yazılan sonucu döndürür.

Evaluate(XPathExpression, XPathNodeIterator)

sağlanan bağlamı kullanarak değerini değerlendirir XPathExpressionve yazılan sonucu döndürür.

GetAttribute(String, String)

Belirtilen yerel ada ve ad alanı URI'sine sahip özniteliğin değerini alır.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetNamespace(String)

Belirtilen yerel ada karşılık gelen ad alanı düğümünün değerini döndürür.

GetNamespacesInScope(XmlNamespaceScope)

Geçerli düğümün kapsam içi ad alanlarını döndürür.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InsertAfter()

Seçili durumdaki düğümden sonra yeni bir eşdüzey düğüm oluşturmak için kullanılan nesneyi XmlWriter döndürür.

InsertAfter(String)

Belirtilen XML dizesini kullanarak seçili durumdaki düğümden sonra yeni bir eşdüzey düğüm oluşturur.

InsertAfter(XmlReader)

Belirtilen nesnenin XML içeriğini XmlReader kullanarak seçili durumdaki düğümden sonra yeni bir eşdüzey düğüm oluşturur.

InsertAfter(XPathNavigator)

Belirtilen nesnedeki XPathNavigator düğümleri kullanarak seçili durumdaki düğümden sonra yeni bir eşdüzey düğüm oluşturur.

InsertBefore()

Seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturmak için kullanılan nesneyi XmlWriter döndürür.

InsertBefore(String)

Belirtilen XML dizesini kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.

InsertBefore(XmlReader)

Belirtilen nesnenin XML içeriğini XmlReader kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.

InsertBefore(XPathNavigator)

Belirtilen düğümlerdeki düğümleri kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm XPathNavigator oluşturur.

InsertElementAfter(String, String, String, String)

Belirtilen değerle belirtilen ad alanı ön ekini, yerel adı ve ad alanı URI'sini kullanarak geçerli düğümden sonra yeni bir eşdüzey öğe oluşturur.

InsertElementBefore(String, String, String, String)

Belirtilen değerle belirtilen ad alanı ön ekini, yerel adı ve ad alanı URI'sini kullanarak geçerli düğümden önce yeni bir eşdüzey öğe oluşturur.

IsDescendant(XPathNavigator)

Belirtilen XPathNavigator öğesinin geçerli XPathNavigatoröğesinin alt öğesinin olup olmadığını belirler.

IsSamePosition(XPathNavigator)

Türetilmiş bir sınıfta geçersiz kılındığında, geçerlinin XPathNavigator belirtilen XPathNavigatorile aynı konumda olup olmadığını belirler.

LookupNamespace(String)

Belirtilen ön ek için ad alanı URI'sini alır.

LookupPrefix(String)

Belirtilen ad alanı URI'si için bildirilen ön eki alır.

Matches(String)

Geçerli düğümün belirtilen XPath ifadesiyle eşleşip eşleşmediğini belirler.

Matches(XPathExpression)

Geçerli düğümün belirtilen XPathExpressionile eşleşip eşleşmediğini belirler.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MoveTo(XPathNavigator)

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini belirtilen XPathNavigatorile aynı konuma taşırXPathNavigator.

MoveToAttribute(String, String)

XPathNavigator eşleşen yerel ad ve ad alanı URI'siyle özniteliğine taşır.

MoveToChild(String, String)

XPathNavigator yerel adı ve ad alanı URI'sini belirtilen alt düğüme taşır.

MoveToChild(XPathNodeType)

öğesini XPathNavigator belirtilen alt düğüme XPathNodeType taşır.

MoveToFirst()

öğesini XPathNavigator geçerli düğümün ilk eşdüzey düğümüne taşır.

MoveToFirstAttribute()

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini geçerli düğümün ilk özniteliğine taşır XPathNavigator .

MoveToFirstChild()

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümün ilk alt düğümüne taşır XPathNavigator .

MoveToFirstNamespace()

geçerli düğümün XPathNavigator ilk ad alanı düğümüne taşır.

MoveToFirstNamespace(XPathNamespaceScope)

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini belirtilen ile eşleşen ilk ad alanı düğümüne XPathNamespaceScope taşırXPathNavigator.

MoveToFollowing(String, String)

XPathNavigator yerel adı ve ad alanı URI'sini belge sırasına göre belirtilen öğesine taşır.

MoveToFollowing(String, String, XPathNavigator)

öğesini XPathNavigator yerel adı ve ad alanı URI'sini belirtilen öğeye, belirtilen sınıra belge sırasına göre taşır.

MoveToFollowing(XPathNodeType)

öğesini XPathNavigator belge sırasına göre belirtilen öğesinin XPathNodeType aşağıdaki öğesine taşır.

MoveToFollowing(XPathNodeType, XPathNavigator)

öğesini XPathNavigator belirtilen öğenin aşağıdaki öğesine XPathNodeType , belirtilen sınıra belge sırasına göre taşır.

MoveToId(String)

Türetilmiş bir sınıfta geçersiz kılındığında, değeri belirtilen Stringile eşleşen tür ID özniteliğine sahip düğüme geçer.

MoveToNamespace(String)

öğesini XPathNavigator belirtilen ad alanı ön ekine sahip ad alanı düğümüne taşır.

MoveToNext()

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini geçerli düğümün bir sonraki eşdüzey düğümüne taşır XPathNavigator .

MoveToNext(String, String)

XPathNavigator yerel adı ve ad alanı URI'sini belirtilen bir sonraki eşdüzey düğüme taşır.

MoveToNext(XPathNodeType)

öğesini XPathNavigator , belirtilen düğümle eşleşen geçerli düğümün bir sonraki eşdüzey düğümüne XPathNodeType taşır.

MoveToNextAttribute()

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini XPathNavigator sonraki özniteliğe taşır.

MoveToNextNamespace()

öğesini XPathNavigator bir sonraki ad alanı düğümüne taşır.

MoveToNextNamespace(XPathNamespaceScope)

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini belirtilenle eşleşen bir sonraki ad alanı düğümüne XPathNamespaceScope taşırXPathNavigator.

MoveToParent()

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini geçerli düğümün üst düğümüne taşır XPathNavigator .

MoveToPrevious()

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini geçerli düğümün önceki eşdüzey düğümüne taşır XPathNavigator .

MoveToRoot()

öğesini XPathNavigator geçerli düğümün ait olduğu kök düğüme taşır.

PrependChild()

XmlWriter Geçerli düğümün alt düğümleri listesinin başında yeni bir alt düğüm oluşturmak için kullanılan nesneyi döndürür.

PrependChild(String)

Belirtilen XML dizesini kullanarak geçerli düğümün alt düğümleri listesinin başında yeni bir alt düğüm oluşturur.

PrependChild(XmlReader)

Belirtilen nesnenin XML içeriğini XmlReader kullanarak geçerli düğümün alt düğümleri listesinin başında yeni bir alt düğüm oluşturur.

PrependChild(XPathNavigator)

Belirtilen nesnedeki düğümleri kullanarak geçerli düğümün alt düğümleri listesinin başında yeni bir alt düğüm XPathNavigator oluşturur.

PrependChildElement(String, String, String, String)

Belirtilen değerle belirtilen ad alanı ön ekini, yerel adı ve ad alanı URI'sini kullanarak geçerli düğümün alt düğümleri listesinin başında yeni bir alt öğe oluşturur.

ReadSubtree()

Geçerli düğümü ve alt düğümlerini içeren bir XmlReader nesne döndürür.

ReplaceRange(XPathNavigator)

Geçerli düğümden belirtilen düğüme eşdüzey düğüm aralığını değiştirir.

ReplaceSelf(String)

Geçerli düğümü belirtilen dizenin içeriğiyle değiştirir.

ReplaceSelf(XmlReader)

Geçerli düğümü belirtilen nesnenin XmlReader içeriğiyle değiştirir.

ReplaceSelf(XPathNavigator)

Geçerli düğümü belirtilen nesnenin XPathNavigator içeriğiyle değiştirir.

Select(String)

Belirtilen XPath ifadesini kullanarak bir düğüm kümesi seçer.

Select(String, IXmlNamespaceResolver)

Ad alanı ön eklerini çözümlemek için belirtilen nesneyle belirtilen IXmlNamespaceResolver XPath ifadesini kullanarak bir düğüm kümesi seçer.

Select(XPathExpression)

Belirtilen XPathExpressionöğesini kullanarak bir düğüm kümesi seçer.

SelectAncestors(String, String, Boolean)

Belirtilen yerel ada ve ad alanı URI'sine sahip geçerli düğümün tüm üst düğümlerini seçer.

SelectAncestors(XPathNodeType, Boolean)

Geçerli düğümün eşleşen XPathNodeTypetüm atası düğümlerini seçer.

SelectChildren(String, String)

Yerel adı ve ad alanı URI'sine sahip geçerli düğümün tüm alt düğümlerini seçer.

SelectChildren(XPathNodeType)

Eşleşen XPathNodeTypegeçerli düğümün tüm alt düğümlerini seçer.

SelectDescendants(String, String, Boolean)

Yerel ad ve ad alanı URI'sinin belirtildiği geçerli düğümün tüm alt düğümlerini seçer.

SelectDescendants(XPathNodeType, Boolean)

Geçerli düğümün eşleşen XPathNodeTypetüm alt düğümlerini seçer.

SelectSingleNode(String)

Belirtilen XPath sorgusunu kullanarak içinde XPathNavigator tek bir düğüm seçer.

SelectSingleNode(String, IXmlNamespaceResolver)

Ad alanı ön eklerini çözümlemek XPathNavigator için belirtilen nesneyle belirtilen XPath sorgusunu kullanarak nesnede IXmlNamespaceResolver tek bir düğüm seçer.

SelectSingleNode(XPathExpression)

belirtilen XPathExpression nesneyi kullanarak içinde XPathNavigator tek bir düğüm seçer.

SetTypedValue(Object)

Geçerli düğümün yazılan değerini ayarlar.

SetValue(String)

Geçerli düğümün değerini ayarlar.

ToString()

Geçerli düğümün metin değerini alır.

ValueAs(Type)

Belirtilen tür olarak öğenin değerini döndürür.

(Devralındığı yer: XPathItem)
ValueAs(Type, IXmlNamespaceResolver)

Ad alanı ön eklerini Type çözümlemek için belirtilen nesneyi kullanarak geçerli düğümün IXmlNamespaceResolver değerini belirtilen şekilde alır.

WriteSubtree(XmlWriter)

Geçerli düğümü ve alt düğümlerini belirtilen nesneye akışla iletir XmlWriter .

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Nesnenin XPathNavigator yeni bir kopyasını oluşturur.

Şunlara uygulanır

Ayrıca bkz.