XContainer.ReplaceNodes Metoda

Definice

Nahradí podřízené uzly tohoto dokumentu nebo prvku zadaným obsahem.Replaces the children nodes of this document or element with the specified content.

Přetížení

ReplaceNodes(Object)

Nahradí podřízené uzly tohoto dokumentu nebo prvku zadaným obsahem.Replaces the children nodes of this document or element with the specified content.

ReplaceNodes(Object[])

Nahradí podřízené uzly tohoto dokumentu nebo prvku zadaným obsahem.Replaces the children nodes of this document or element with the specified content.

Příklady

Následující příklad vytvoří dvě stromy XML a poté pomocí této metody nahradí obsah jednoho z nich výsledky dotazu.The following example creates two XML trees, and then uses this method to replace the contents of one of them with the results of a query.

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)  

Tento příklad vytvoří následující výstup:This example produces the following output:

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

Poznámky

Podrobnosti o platném obsahu, který lze předat této funkci, naleznete v tématu platný obsah objektů XElement a XDocument.For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

Tato metoda vyvolá Changed Changing události a.This method will raise the Changed and the Changing events.

Tato metoda má sémantiku snímku.This method has snapshot semantics. Nejprve vytvoří kopii nového obsahu.It first creates a copy of the new content. Pak odebere všechny podřízené uzly tohoto uzlu.It then removes all children nodes of this node. Nakonec přidá nový obsah jako podřízené uzly.Finally, it adds the new content as children nodes. To znamená, že můžete nahradit podřízené uzly pomocí dotazu na podřízených uzlech samotných.This means that you can replace children nodes using a query on the children nodes themselves.

ReplaceNodes(Object)

Nahradí podřízené uzly tohoto dokumentu nebo prvku zadaným obsahem.Replaces the children nodes of this document or element with the specified content.

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

Parametry

content
Object

Objekt Content obsahující jednoduchý obsah nebo kolekci objektů obsahu, které nahrazují podřízené uzly.A content object containing simple content or a collection of content objects that replace the children nodes.

Příklady

Následující příklad vytvoří strom XML, který obsahuje podřízené uzly.The following example creates an XML tree that contains children nodes. Pak nahradí všechny podřízené uzly jediným prvkem.It then replaces all of the children nodes with a single element.

Chcete-li zobrazit příklad nahrazení podřízených uzlů výsledky dotazu LINQ, přečtěte si téma ReplaceNodes .To see an example of replacing the children nodes with the results of a LINQ query, see 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)  

Tento příklad vytvoří následující výstup:This example produces the following output:

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

Poznámky

Podrobnosti o platném obsahu, který lze předat této funkci, naleznete v tématu platný obsah objektů XElement a XDocument.For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

Tato metoda vyvolá Changed Changing události a.This method will raise the Changed and the Changing events.

Tato metoda má sémantiku snímku.This method has snapshot semantics. Nejprve vytvoří kopii nového obsahu.It first creates a copy of the new content. Pak odebere všechny podřízené uzly tohoto uzlu.It then removes all children nodes of this node. Nakonec přidá nový obsah jako podřízené uzly.Finally, it adds the new content as children nodes. To znamená, že můžete nahradit podřízené uzly pomocí dotazu na podřízených uzlech samotných.This means that you can replace children nodes using a query on the children nodes themselves.

Viz také

Platí pro

ReplaceNodes(Object[])

Nahradí podřízené uzly tohoto dokumentu nebo prvku zadaným obsahem.Replaces the children nodes of this document or element with the specified content.

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())

Parametry

content
Object[]

Seznam parametrů objektů obsahu.A parameter list of content objects.

Příklady

Následující příklad vytvoří slovník a strom XML.The following example creates a dictionary and an XML tree. Pak se dotazuje do slovníku, projekty výsledky do a IEnumerable<T> XElement nahradí obsah stromu XML výsledky dotazu.It then queries the dictionary, projects the results to an IEnumerable<T> of XElement, and replaces the contents of the XML tree with the results of the query.

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)  

Tento příklad vytvoří následující výstup:This example produces the following output:

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

Poznámky

Podrobnosti o platném obsahu, který lze předat této funkci, naleznete v tématu platný obsah objektů XElement a XDocument.For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

Tato metoda vyvolá Changed Changing události a.This method will raise the Changed and the Changing events.

Tato metoda má sémantiku snímku.This method has snapshot semantics. Nejprve vytvoří kopii nového obsahu.It first creates a copy of the new content. Pak odebere všechny podřízené uzly tohoto uzlu.It then removes all children nodes of this node. Nakonec přidá nový obsah jako podřízené uzly.Finally, it adds the new content as children nodes. To znamená, že můžete nahradit podřízené uzly pomocí dotazu na podřízených uzlech samotných.This means that you can replace children nodes using a query on the children nodes themselves.

Viz také

Platí pro