XContainer.Add 方法

定義

命名空間:

System.Xml.Linq

組件:

netstandard.dll, System.Xml.XDocument.dll

會將指定內容加入子 XContainer節點。

多載

名稱	Description
Add(Object)	將指定內容作為此 XContainer的子節點加入。
Add(Object[])	將指定內容作為此 XContainer的子節點加入。

範例

以下範例建立兩棵 XML 樹，並使用此方法將查詢結果加入其中一棵樹。

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)

此範例會產生下列輸出：

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

備註

此方法在 的既有內容 XContainer之後加入新內容。

關於可傳遞給此函式的有效內容細節，請參見 XElement 與 XDocument 物件的有效內容。

這種方法會提升事件ChangedChanging。

Add(Object)

來源:

XContainer.cs

將指定內容作為此 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

包含簡單內容或一組待加入的內容物件。

範例

以下範例建立兩棵 XML 樹，然後使用此方法將物件加入 XElement 其中一棵樹。 它也會將 LINQ 查詢的結果加入 XML 樹。

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)

此範例會產生下列輸出：

<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之後加入新內容。

關於可傳遞給此函式的有效內容細節，請參見 XElement 與 XDocument 物件的有效內容。

這種方法會提升事件ChangedChanging。

另請參閱

• AddFirst
• RemoveNodes()
• ReplaceNodes
• LINQ to XML 概觀

Add(Object[])

來源:

XContainer.cs

將指定內容作為此 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[]

內容物件的參數清單。

範例

以下範例建立兩棵 XML 樹，並使用此方法將物件加入 XElement 其中一棵樹。 它也會將 LINQ 查詢的結果加入 XML 樹。

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)

此範例會產生下列輸出：

<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之後加入新內容。

關於可傳遞給此函式的有效內容細節，請參見 XElement 與 XDocument 物件的有效內容。

這種方法會提升事件ChangedChanging。

另請參閱

• AddFirst
• RemoveNodes()
• ReplaceNodes
• LINQ to XML 概觀