XContainer.Add XContainer.Add XContainer.Add XContainer.Add Method

Definição

Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children to this XContainer.

Sobrecargas

Add(Object) Add(Object) Add(Object) Add(Object)

Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children of this XContainer.

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children of this XContainer.

Exemplos

O exemplo a seguir cria duas árvores XML e, em seguida, usa esse método para adicionar os resultados de uma consulta para um deles.The following example creates two XML trees, and then uses this method to add the results of a query to one of them.

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("NewElement", "Content")  
);  
xmlTree.Add(  
    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>  
            <NewElement>Content</NewElement>  
        </Root>  
xmlTree.Add( _  
    From el In srcTree.Elements _  
    Where CInt(el) >= 3 _  
    Select el)  
Console.WriteLine(xmlTree)  

Este exemplo gera a seguinte saída:This example produces the following output:

<Root>  
  <NewElement>Content</NewElement>  
  <Element3>3</Element3>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
</Root>  

Comentários

Esse método adiciona o novo conteúdo após o conteúdo existente do XContainer.This method adds the new content after the existing content of the XContainer.

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

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

Add(Object) Add(Object) Add(Object) Add(Object)

Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children of this XContainer.

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

Parâmetros

content
Object Object Object Object

Um objeto de conteúdo que contém o conteúdo simples ou uma coleção de objetos de conteúdo a ser adicionada.A content object containing simple content or a collection of content objects to be added.

Exemplos

O exemplo a seguir cria duas árvores XML e, em seguida, usa esse método para adicionar um XElement objeto para um deles.The following example creates two XML trees, and then uses this method to add an XElement object to one of them. Ele também adiciona os resultados de uma LINQLINQ consulta à árvore XML.It also adds the results of a LINQLINQ query to the XML tree.

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)  
);  
xmlTree.Add(new XElement("NewChild", "new content"));  
xmlTree.Add(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
// Even though Child9 does not exist in srcTree, the following statement will not  
// throw an exception, and nothing will be added to xmlTree.  
xmlTree.Add(srcTree.Element("Child9"));  
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>  

xmlTree.Add(New XElement("NewChild", "new content"))  
xmlTree.Add( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el _  
)  
' Even though Child9 does not exist in srcTree, the following statement will not  
' throw an exception, and nothing will be added to xmlTree.  
xmlTree.Add(srcTree.<Child9>)  
Console.WriteLine(xmlTree)  

Este exemplo gera a seguinte saída:This example produces the following output:

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

Comentários

Esse método adiciona o novo conteúdo após o conteúdo existente do XContainer.This method adds the new content after the existing content of the XContainer.

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

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

Veja também

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children of this XContainer.

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

Parâmetros

content
Object[]

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

Exemplos

O exemplo a seguir cria duas árvores XML, usa esse método para adicionar um XElement objeto para um deles.The following example creates two XML trees, uses this method to add an XElement object to one of them. Ele também adiciona os resultados de uma LINQLINQ consulta à árvore XML.It also adds the results of a LINQLINQ query to the XML tree.

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)  
);  
xmlTree.Add(new XElement("NewChild", "new content"));  
xmlTree.Add(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
// Even though Child9 does not exist in srcTree, the following statement will not  
// throw an exception, and nothing will be added to xmlTree  
xmlTree.Add(srcTree.Element("Child9"));  
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>  

xmlTree.Add(New XElement("NewChild", "new content"))  
xmlTree.Add( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el _  
)  
' Even though Child9 does not exist in srcTree, the following statement will not  
' throw an exception, and nothing will be added to xmlTree  
xmlTree.Add(srcTree.<Child9>)  
Console.WriteLine(xmlTree)  

Este exemplo gera a seguinte saída:This example produces the following output:

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

Comentários

Esse método adiciona o novo conteúdo após o conteúdo existente do XContainer.This method adds the new content after the existing content of the XContainer.

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

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

Veja também

Aplica-se a