XNode.CompareDocumentOrder(XNode, XNode) メソッド

定義

名前空間:

System.Xml.Linq

アセンブリ:

System.Xml.XDocument.dll

Source:

XNode.cs

2 つのノードを比較してそれらの相対的な 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);

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

比較する 2 番目の XNode。

戻り値

Int32

ノードが等しい場合には 0 を格納する int。n1 が n2 より前の場合には -1。n1 が n2 より後ろの場合には 1。

例外

InvalidOperationException

2 つのノードが共通の先祖を共有していません。

例

次の例では、このメソッドを使用します。

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 、その子ノードを 1 つのリンクされたオブジェクトの XNode リストとして格納します。 これは、メソッドが CompareDocumentOrder 共通の親を見つけるまで、比較対象の 2 つのノードの先祖を走査する必要があることを意味します。 次に、共通の親の子ノードの一覧を走査して、比較する 2 つのノードの順序を決定する必要があります。 したがって、この方法を使用すると、パフォーマンスに影響する可能性があります。

こちらもご覧ください

• LINQ to XML の概要