XContainer.ReplaceNodes Método

Definição

Espaço de Nomes:: System.Xml.Linq

Assemblagens:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Assemblagem:: System.Xml.Linq.dll

Assemblagem:: System.Xml.XDocument.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Substitui os nós filhos deste documento ou elemento pelo conteúdo especificado.

Sobrecargas

Name	Description
ReplaceNodes(Object)	Substitui os nós filhos deste documento ou elemento pelo conteúdo especificado.
ReplaceNodes(Object[])	Substitui os nós filhos deste documento ou elemento pelo conteúdo especificado.

Exemplos

O exemplo seguinte cria duas árvores XML e depois usa este método para substituir o conteúdo de uma delas pelos resultados de uma consulta.

XElement root = new XElement("Root",
    new XElement("Child", 1),
    new XElement("Child", 2),
    new XElement("Child", 3),
    new XElement("Child", 4),
    new XElement("Child", 5)
);
root.ReplaceNodes(
    from el in root.Elements()
    where (int)el >= 3
    select el
);
Console.WriteLine(root);

Dim root As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>
root.ReplaceNodes( _
    From el In root.Elements _
    Where el.Value >= 3 _
    Select el)
Console.WriteLine(root)

Este exemplo produz a seguinte saída:

<Root>
  <Child>3</Child>
  <Child>4</Child>
  <Child>5</Child>
</Root>

Observações

Para detalhes sobre o conteúdo válido que pode ser passado para esta função, consulte Conteúdo Válido dos Objetos XElement e XDocument.

Este método irá aumentar os Changed e os Changing eventos.

Este método tem semântica de snapshot. Primeiro cria uma cópia do novo conteúdo. Depois, remove todos os nós filhos desse nó. Finalmente, adiciona o novo conteúdo como nós filhos. Isto significa que pode substituir os nós filhos usando uma consulta nos próprios nós filhos.

ReplaceNodes(Object)

Substitui os nós filhos deste documento ou elemento pelo conteúdo especificado.

public:
 void ReplaceNodes(System::Object ^ content);

public void ReplaceNodes(object content);

member this.ReplaceNodes : obj -> unit

Public Sub ReplaceNodes (content As Object)

Parâmetros

content: Object

Um objeto de conteúdo contendo conteúdo simples ou uma coleção de objetos de conteúdo que substituem os nós filhos.

Exemplos

O exemplo seguinte cria uma árvore XML que contém nós filhos. Depois, substitui todos os nós filhos por um único elemento.

Para ver um exemplo de substituir os nós filhos pelos resultados de uma consulta LINQ, veja ReplaceNodes.

XElement root = new XElement("Root",
    new XElement("Child", 1),
    new XElement("Child", 2),
    new XElement("Child", 3),
    new XElement("Child", 4),
    new XElement("Child", 5)
);
root.ReplaceNodes(
    from el in root.Elements()
    where (int)el >= 3
    select el
);
Console.WriteLine(root);

Dim root As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>
root.ReplaceNodes( _
    From el In root.Elements _
    Where el.Value >= 3 _
    Select el)
Console.WriteLine(root)

Este exemplo produz a seguinte saída:

<Root>
  <Child>3</Child>
  <Child>4</Child>
  <Child>5</Child>
</Root>

Observações

Para detalhes sobre o conteúdo válido que pode ser passado para esta função, consulte Conteúdo Válido dos Objetos XElement e XDocument.

Este método irá aumentar os Changed e os Changing eventos.

Ver também

Aplica-se a

ReplaceNodes(Object[])

Substitui os nós filhos deste documento ou elemento pelo conteúdo especificado.

public:
 void ReplaceNodes(... cli::array <System::Object ^> ^ content);

public void ReplaceNodes(params object[] content);

member this.ReplaceNodes : obj[] -> unit

Public Sub ReplaceNodes (ParamArray content As Object())

Parâmetros

content: Object[]

Uma lista de parâmetros de objetos de conteúdo.

Exemplos

O exemplo seguinte cria um dicionário e uma árvore XML. Depois, consulta o dicionário, projeta os resultados para um IEnumerable<T> de XElement, e substitui o conteúdo da árvore XML pelos resultados da consulta.

XElement root = new XElement("Root",
    new XElement("Child", 1),
    new XElement("Child", 2),
    new XElement("Child", 3),
    new XElement("Child", 4),
    new XElement("Child", 5)
);
root.ReplaceNodes(
    from el in root.Elements()
    where (int)el >= 3
    select el
);
Console.WriteLine(root);

Dim root As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>
root.ReplaceNodes( _
    From el In root.Elements _
    Where el.Value >= 3 _
    Select el)
Console.WriteLine(root)

Este exemplo produz a seguinte saída:

<Root>
  <Child>3</Child>
  <Child>4</Child>
  <Child>5</Child>
</Root>

Observações

Para detalhes sobre o conteúdo válido que pode ser passado para esta função, consulte Conteúdo Válido dos Objetos XElement e XDocument.

Este método irá aumentar os Changed e os Changing eventos.

Ver também

Aplica-se a

Comentários

Esta página foi útil?