XPathNavigator.ComparePosition(XPathNavigator) Yöntem

Tanım

Geçerli konumunun konumunu XPathNavigator belirtilen konumuyla karşılaştırır XPathNavigator .Compares the position of the current XPathNavigator with the position of the XPathNavigator specified.

public:
 virtual System::Xml::XmlNodeOrder ComparePosition(System::Xml::XPath::XPathNavigator ^ nav);
public virtual System.Xml.XmlNodeOrder ComparePosition (System.Xml.XPath.XPathNavigator? nav);
public virtual System.Xml.XmlNodeOrder ComparePosition (System.Xml.XPath.XPathNavigator nav);
abstract member ComparePosition : System.Xml.XPath.XPathNavigator -> System.Xml.XmlNodeOrder
override this.ComparePosition : System.Xml.XPath.XPathNavigator -> System.Xml.XmlNodeOrder
Public Overridable Function ComparePosition (nav As XPathNavigator) As XmlNodeOrder

Parametreler

nav
XPathNavigator

XPathNavigatorKarşılaştırılacak.The XPathNavigator to compare against.

Döndürülenler

XmlNodeOrder

XmlNodeOrderİki nesnenin karşılaştırılma konumunu temsil eden bir değer XPathNavigator .An XmlNodeOrder value representing the comparative position of the two XPathNavigator objects.

Açıklamalar

Aşağıdaki tablo, numaralandırmayı açıklar XmlNodeOrder .The following table describes the XmlNodeOrder enumeration.

XmlNodeOrderXmlNodeOrder DescriptionDescription
Before Bunun geçerli düğümü, XPathNavigator sağlanan geçerli düğümünden öncedir XPathNavigator .The current node of this XPathNavigator is before the current node of the supplied XPathNavigator.
After Bunun geçerli düğümü, XPathNavigator sağlanan geçerli düğümünden daha sonra XPathNavigator .The current node of this XPathNavigator is after the current node of the supplied XPathNavigator.
Same İki XPathNavigator nesne aynı düğümde konumlandırılmış.The two XPathNavigator objects are positioned on the same node.
Unknown Düğüm konumları, belge düzeninde birbirlerine göre belirlenemez veya null parametresi olarak belirtilir XPathNavigator .The node positions cannot be determined relative to each other in the document order, or null is specified as the XPathNavigator parameter. İki düğüm farklı ağaçlarda bulunuyorsa bu durum oluşabilir.This could occur if the two nodes reside in different trees.

ComparePositionYöntemin davranışı, XPathNodeType XPathNavigator Şu anda üzerine konumlandırılmış olan öğesine bağımlıdır.The ComparePosition method's behavior is dependent on the XPathNodeType the XPathNavigator is currently positioned on. XML belgesindeki düğümleri karşılaştırırken, aşağıdaki kurallar geçerlidir:When comparing nodes in the XML document, the following rules apply:

  • Element düğümler: Bu düğümler, kaynak belgeden belge sırasıyla döndürülür.Element nodes: These nodes are returned in document order from the source document.

  • Namespace düğümler: Bu düğümler belge düzeninde döndürülebilecek ve her zaman Attribute üst öğenin düğümlerinden önceye ait olabilir.Namespace nodes: These nodes may be returned in document order and are always before the Attribute nodes of the parent element.

  • Attribute düğümler: Bu düğümler belge sırasıyla döndürülebilir.Attribute nodes: These nodes may be returned in document order. Bunlar her zaman Namespace düğümler ve üst düğümün alt düğümlerinden önce gelir.They always come after the Namespace nodes and before any child nodes of the parent node.

Not

XPath veri modeli ve düğüm türlerinin her biri hakkındaki ayrıntılar hakkında daha fazla bilgi için bkz. W3C XML Path Language (XPath) önerisinin 5. bölümü.For more information about the XPath data model and details about each of the node types, see section 5 of the W3C XML Path Language (XPath) recommendation.

Bu yöntemin durumu üzerinde hiçbir etkisi yoktur XPathNavigator .This method has no effect on the state of the XPathNavigator.

Not

IsSamePositionMümkün olduğunda yöntemi yerine yöntemini kullanın ComparePosition .Use the IsSamePosition method rather than the ComparePosition method when possible.

Şunlara uygulanır

Ayrıca bkz.