Compartir vía

XNode.CompareDocumentOrder(XNode, XNode) Método

  • Referencia

Definición

Espacio de nombres:
System.Xml.Linq
Ensamblado:
System.Xml.XDocument.dll
Ensamblado:
System.Xml.Linq.dll
Ensamblado:
netstandard.dll
Source:
XNode.cs
Source:
XNode.cs
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);
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.

Se aplica a

Consulte también