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

定义

将指定的内容作为子级添加到此 XContainerAdds the specified content as children to this XContainer.

重载

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

将指定的内容添加为此 XContainer 的子级。Adds the specified content as children of this XContainer.

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

将指定的内容添加为此 XContainer 的子级。Adds the specified content as children of this XContainer.

示例

下面的示例创建两个 XML 树,然后使用此方法将查询结果添加到其中之一。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)  

该示例产生下面的输出:This example produces the following output:

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

注解

此方法将新内容添加到的XContainer现有内容之后。This method adds the new content after the existing content of the XContainer.

有关可传递到此函数的有效内容的详细信息,请参阅system.xml.linq.xelement> 和 XDocument 对象的有效内容For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

此方法将引发Changed Changing和事件。This method will raise the Changed and the Changing events.

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

将指定的内容添加为此 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)

参数

content
Object Object Object Object

要添加的包含简单内容的内容对象或内容对象集合。A content object containing simple content or a collection of content objects to be added.

示例

下面的示例创建两个 XML 树,然后使用此方法将一个XElement对象添加到其中一个。The following example creates two XML trees, and then uses this method to add an XElement object to one of them. 它还会将LINQLINQ查询结果添加到 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)  

该示例产生下面的输出: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>  

注解

此方法将新内容添加到的XContainer现有内容之后。This method adds the new content after the existing content of the XContainer.

有关可传递到此函数的有效内容的详细信息,请参阅system.xml.linq.xelement> 和 XDocument 对象的有效内容For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

此方法将引发Changed Changing和事件。This method will raise the Changed and the Changing events.

另请参阅

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

将指定的内容添加为此 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())

参数

content
Object[]

内容对象的参数列表。A parameter list of content objects.

示例

下面的示例创建两个 XML 树,并使用此方法将XElement一个对象添加到其中一个。The following example creates two XML trees, uses this method to add an XElement object to one of them. 它还会将LINQLINQ查询结果添加到 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)  

该示例产生下面的输出: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>  

注解

此方法将新内容添加到的XContainer现有内容之后。This method adds the new content after the existing content of the XContainer.

有关可传递到此函数的有效内容的详细信息,请参阅system.xml.linq.xelement> 和 XDocument 对象的有效内容For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

此方法将引发Changed Changing和事件。This method will raise the Changed and the Changing events.

另请参阅

适用于