XNode.AddBeforeSelf Método

  • Referencia

Definición

Espacio de nombres:
System.Xml.Linq
Ensamblado:
System.Xml.XDocument.dll
Ensamblado:
System.Xml.Linq.dll
Ensamblado:
netstandard.dll

Agrega el contenido especificado inmediatamente antes de este nodo.

Sobrecargas

AddBeforeSelf(Object)

Agrega el contenido especificado inmediatamente antes de este nodo.
AddBeforeSelf(Object[])

Agrega el contenido especificado inmediatamente antes de este nodo.

Ejemplos

En el ejemplo siguiente se usa una consulta LINQ para crear un IEnumerable<T> de XElement, que luego pasa a este método. Esto agrega los resultados de una consulta al árbol en la ubicación deseada.

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
Console.WriteLine(xmlTree);  

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  

Dim xmlTree As XElement = _   
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  

Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf( _  
From el In srcTree.Elements() _  
Where CInt(el) > 3 _  
Select el)  

Console.WriteLine(xmlTree)

Este ejemplo produce el siguiente resultado:

<Root>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

Comentarios

Para obtener más información sobre el contenido válido que se puede pasar a este método, vea Contenido válido de objetos XElement y XDocument.

Este método generará los Changed eventos y Changing .

XContainer almacena sus notas secundarias como una lista vinculada de forma singly de XNode objetos. Esto significa que el AddBeforeSelf método debe recorrer la lista de nodos secundarios directos en el contenedor primario. Por lo tanto, el uso de este método puede afectar al rendimiento.

AddBeforeSelf(Object)

Agrega el contenido especificado inmediatamente antes de este nodo.

public:
 void AddBeforeSelf(System::Object ^ content);
public void AddBeforeSelf (object content);
public void AddBeforeSelf (object? content);
member this.AddBeforeSelf : obj -> unit
Public Sub AddBeforeSelf (content As Object)

Parámetros

content
Object

Un objeto de contenido que incluye contenido simple o una colección de objetos de contenido que se van a agregar antes de este nodo.

Excepciones

InvalidOperationException

El valor del elemento primario es null.

Ejemplos

En el ejemplo siguiente se usa este método para agregar un elemento al árbol.

XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    new XElement("NewChild", 10)  
);  
Console.WriteLine(xmlTree);  

Dim xmlTree As XElement = _   
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  

Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf(New XElement("NewChild", 10))  
Console.WriteLine(xmlTree)

Este ejemplo produce el siguiente resultado:

<Root>  
  <NewChild>10</NewChild>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

Comentarios

Para obtener más información sobre el contenido válido que se puede pasar a este método, vea Contenido válido de objetos XElement y XDocument.

Este método generará los Changed eventos y Changing .

XContainer almacena sus nodos secundarios como una lista vinculada de forma singly de XNode objetos. Esto significa que el AddBeforeSelf método debe recorrer la lista de nodos secundarios directos en el contenedor primario. Por lo tanto, el uso de este método puede afectar al rendimiento.

Consulte también

Se aplica a

AddBeforeSelf(Object[])

Agrega el contenido especificado inmediatamente antes de este nodo.

public:
 void AddBeforeSelf(... cli::array <System::Object ^> ^ content);
public void AddBeforeSelf (params object[] content);
public void AddBeforeSelf (params object?[] content);
member this.AddBeforeSelf : obj[] -> unit
Public Sub AddBeforeSelf (ParamArray content As Object())

Parámetros

content
Object[]

Lista de parámetros de objetos de contenido.

Excepciones

InvalidOperationException

El valor del elemento primario es null.

Ejemplos

En el ejemplo siguiente se usa una consulta LINQ para crear un IEnumerable<T> de XElement, que luego pasa a este método. Esto agrega los resultados de una consulta al árbol en la ubicación deseada.

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
Console.WriteLine(xmlTree);  

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  

Dim xmlTree As XElement = _   
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  

Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el)  

Console.WriteLine(xmlTree)

Este ejemplo produce el siguiente resultado:

<Root>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

Comentarios

Para obtener más información sobre el contenido válido que se puede pasar a este método, vea Contenido válido de objetos XElement y XDocument.

Este método generará los Changed eventos y Changing .

XContainer almacena sus nodos secundarios como una lista vinculada de forma singly de XNode objetos. Esto significa que el AddBeforeSelf método debe recorrer la lista de nodos secundarios directos en el contenedor primario. Por lo tanto, el uso de esta función puede afectar al rendimiento.

Consulte también

Se aplica a