XNode.CompareDocumentOrder(XNode, XNode) 方法

定義

命名空間:
System.Xml.Linq
組件:
System.Xml.Linq.dll, System.Xml.XDocument.dll
組件:
netstandard.dll, System.Xml.XDocument.dll
組件:
System.Xml.XDocument.dll
組件:
System.Xml.Linq.dll
組件:
netstandard.dll
來源:
XNode.cs
來源:
XNode.cs
來源:
XNode.cs
來源:
XNode.cs
來源:
XNode.cs

比較兩個節點以判定其相對的 XML 文件順序。

public:
 static int CompareDocumentOrder(System::Xml::Linq::XNode ^ n1, System::Xml::Linq::XNode ^ n2);
public static int CompareDocumentOrder(System.Xml.Linq.XNode n1, System.Xml.Linq.XNode n2);
public static int CompareDocumentOrder(System.Xml.Linq.XNode? n1, System.Xml.Linq.XNode? n2);
static member CompareDocumentOrder : System.Xml.Linq.XNode * System.Xml.Linq.XNode -> int
Public Shared Function CompareDocumentOrder (n1 As XNode, n2 As XNode) As Integer

參數

n1
XNode

首先 XNode 比較一下。

n2
XNode

第二個 XNode 比較。

傳回

Int32

int若節點相等，則包含 0;-1 若n1節點在n2之前;1 若n1在 之後n2。

例外狀況

InvalidOperationException

這兩個節點並不共享共同祖先。

範例

以下範例使用了此方法。

XElement xmlTree = new XElement("Root",
    new XElement("Child1",
        new XElement("GrandChild1", 1),
        new XElement("GrandChild2", 2),
        new XElement("GrandChild3", 3)
    ),
    new XElement("Child2",
        new XElement("GrandChild4", 4),
        new XElement("GrandChild5", 5),
        new XElement("GrandChild6", 6)
    )
);
XElement el1 = xmlTree.Descendants("GrandChild2").First();
XElement el2 = xmlTree.Descendants("GrandChild6").First();
if (XElement.CompareDocumentOrder(el1, el2) == 0)
    Console.WriteLine("Compared elements are the same element");
else if (XElement.CompareDocumentOrder(el1, el2) > 0)
    Console.WriteLine("el1 is after el2");
else
    Console.WriteLine("el1 is before el2");

Dim xmlTree As XElement = _
        <Root>
            <Child1>
                <GrandChild1>1</GrandChild1>
                <GrandChild2>2</GrandChild2>
                <GrandChild3>3</GrandChild3>
            </Child1>
            <Child2>
                <GrandChild4>4</GrandChild4>
                <GrandChild5>5</GrandChild5>
                <GrandChild6>6</GrandChild6>
            </Child2>
        </Root>

Dim el1 As XElement = xmlTree...<GrandChild2>(0)
Dim el2 As XElement = xmlTree...<GrandChild6>(0)

If (XElement.CompareDocumentOrder(el1, el2) = 0) Then
    Console.WriteLine("Compared elements are the same element")
ElseIf (XElement.CompareDocumentOrder(el1, el2) > 0) Then
    Console.WriteLine("el1 is after el2")
Else
    Console.WriteLine("el1 is before el2")
End If

此範例會產生下列輸出：

el1 is before el2

備註

它 XContainer 將子節點儲存為單一連結串列 XNode 的物件。 這表示該 CompareDocumentOrder 方法必須遍歷兩個被比較節點的祖先節點，直到找到共同的父節點。 接著必須遍歷公共父節點的子節點清單，以決定被比較的兩個節點的順序。 因此，使用這種方法可能會影響你的表現。

適用於

另請參閱