XContainer.Add Método
Definição
Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children to this XContainer.
Sobrecargas
Add(Object) |
Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children of this XContainer. |
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 a 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)
Esse exemplo gera a saída a seguir: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 conteúdo válido 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 irá gerar o Changed e os Changing eventos.This method will raise the Changed and the Changing events.
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);
public void Add (object? content);
member this.Add : obj -> unit
Public Sub Add (content As Object)
Parâmetros
- content
- 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 a 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)
Esse exemplo gera a saída a seguir: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 conteúdo válido 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 irá gerar o Changed e os Changing eventos.This method will raise the Changed and the Changing events.
Confira também
Aplica-se a
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 a 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)
Esse exemplo gera a saída a seguir: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 conteúdo válido 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 irá gerar o Changed e os Changing eventos.This method will raise the Changed and the Changing events.