XNode.CompareDocumentOrder(XNode, XNode) Método

Definición

Espacio de nombres:

System.Xml.Linq

Ensamblado:

System.Xml.XDocument.dll

Source:

XNode.cs

Compara dos nodos para determinar el orden relativo de sus documentos 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

Parámetros

n1

XNode

Primera XNode que se va a comparar.

n2

XNode

Segunda XNode que se va a comparar.

Devoluciones

Int32

Valor de tipo int que contiene 0 si los nodos son iguales; -1 si n1 está antes de n2; 1 si n1 está después de n2.

Excepciones

InvalidOperationException

Los dos nodos no comparten un antecesor común.

Ejemplos

En el ejemplo siguiente se usa este método.

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  

Este ejemplo produce el siguiente resultado:

el1 is before el2  

Comentarios

XContainer almacena sus nodos secundarios como una lista vinculada de forma singly de XNode objetos. Esto significa que el CompareDocumentOrder método debe atravesar los antecesores de los dos nodos que se comparan hasta que encuentre el elemento primario común. A continuación, debe atravesar la lista de nodos secundarios del elemento primario común para determinar el orden de los dos nodos que se comparan. Por lo tanto, el uso de este método podría afectar al rendimiento.

Consulte también

• Información general de LINQ to XML