XNode.CompareDocumentOrder(XNode, XNode) Метод

  • Ссылка

Определение

Пространство имен:
System.Xml.Linq
Сборка:
System.Xml.XDocument.dll
Сборка:
System.Xml.Linq.dll
Сборка:
netstandard.dll

Сравнивает два узла с целью определения относительного порядка их следования в документе 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 метод должен проходить через предков двух узлов, сравниваемых до тех пор, пока не найдет общий родительский объект. Затем он должен пройти по списку дочерних узлов общего родителя, чтобы определить порядок сравнения двух узлов. Поэтому использование этого метода может повлиять на производительность.

Применяется к

См. также раздел