XNode.AddBeforeSelf Método

Definição

Adiciona o conteúdo especificado imediatamente antes deste nó.Adds the specified content immediately before this node.

Sobrecargas

AddBeforeSelf(Object)

Adiciona o conteúdo especificado imediatamente antes deste nó.Adds the specified content immediately before this node.

AddBeforeSelf(Object[])

Adiciona o conteúdo especificado imediatamente antes deste nó.Adds the specified content immediately before this node.

Exemplos

O exemplo a seguir usa uma consulta LINQ para criar um IEnumerable<T> de XElement , que então passa para esse método.The following example uses a LINQ query to create an IEnumerable<T> of XElement, which it then passes to this method. Isso adiciona os resultados de uma consulta à árvore no local desejado.This adds the results of a query to the tree in the desired location.

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)  

Esse exemplo gera a saída a seguir:This example produces the following output:

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

Comentários

Para obter detalhes sobre o conteúdo válido que pode ser passado para esse método, consulte conteúdo válido de objetos XElement e XDocument.For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

Esse método irá gerar os Changed Changing eventos e.This method will raise the Changed and Changing events.

O XContainer armazena suas anotações filho como uma lista de objetos vinculada individualmente XNode .The XContainer stores its child notes as a singly-linked list of XNode objects. Isso significa que o AddBeforeSelf método deve atravessar a lista de nós filho diretos no contêiner pai.This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. Portanto, o uso desse método pode afetar o desempenho.Therefore, using this method might affect your performance.

AddBeforeSelf(Object)

Adiciona o conteúdo especificado imediatamente antes deste nó.Adds the specified content immediately before this node.

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

Um objeto de conteúdo que contém conteúdo simples ou uma coleção de objetos de conteúdo a ser adicionada antes deste nó.A content object that contains simple content or a collection of content objects to be added before this node.

Exceções

O pai é null.The parent is null.

Exemplos

O exemplo a seguir usa esse método para adicionar um elemento à árvore.The following example uses this method to add an element into the tree.

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)  

Esse exemplo gera a saída a seguir:This example produces the following output:

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

Comentários

Para obter detalhes sobre o conteúdo válido que pode ser passado para esse método, consulte conteúdo válido de objetos XElement e XDocument.For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

Esse método irá gerar o Changed e os Changing eventos.This method will raise the Changed and the Changing events.

O XContainer armazena seus nós filho como uma lista de objetos vinculada individualmente XNode .The XContainer stores its child nodes as a singly-linked list of XNode objects. Isso significa que o AddBeforeSelf método deve atravessar a lista de nós filho diretos no contêiner pai.This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. Portanto, o uso desse método pode afetar o desempenho.Therefore, using this method might affect your performance.

Aplica-se a

AddBeforeSelf(Object[])

Adiciona o conteúdo especificado imediatamente antes deste nó.Adds the specified content immediately before this node.

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

Parâmetros

content
Object[]

Uma lista de parâmetros de objetos de conteúdo.A parameter list of content objects.

Exceções

O pai é null.The parent is null.

Exemplos

O exemplo a seguir usa uma consulta LINQ para criar um IEnumerable<T> de XElement , que então passa para esse método.The following example uses a LINQ query to create an IEnumerable<T> of XElement, which it then passes to this method. Isso adiciona os resultados de uma consulta à árvore no local desejado.This adds the results of a query to the tree in the desired location.

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)  

Esse exemplo gera a saída a seguir:This example produces the following output:

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

Comentários

Para obter detalhes sobre o conteúdo válido que pode ser passado para esse método, consulte conteúdo válido de objetos XElement e XDocument.For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

Esse método irá gerar o Changed e os Changing eventos.This method will raise the Changed and the Changing events.

O XContainer armazena seus nós filho como uma lista de objetos vinculada individualmente XNode .The XContainer stores its child nodes as a singly-linked list of XNode objects. Isso significa que o AddBeforeSelf método deve atravessar a lista de nós filho diretos no contêiner pai.This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. Portanto, o uso dessa função pode afetar o desempenho.Therefore, using this function might affect your performance.

Aplica-se a