XContainer.AddFirst 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
加入指定的內容，以當做此文件或項目的第一個子系。
| AddFirst(Object) |
加入指定的內容，以當做此文件或項目的第一個子系。 |
| AddFirst(Object[]) |
加入指定的內容，以當做此文件或項目的第一個子系。 |
下列範例會建立兩個 XML 樹狀結構，然後使用此方法將查詢的結果新增至其中一個。
C#
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.AddFirst(
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.AddFirst( _
From el In srcTree.Elements _
Where CInt(el) >= 3 _
Select el)
Console.WriteLine(xmlTree)
這個範例會產生下列輸出：
XML
<Root>
<Element3>3</Element3>
<Element4>4</Element4>
<Element5>5</Element5>
<NewElement>Content</NewElement>
</Root>
這個方法會在 的現有內容之前加入新的內容 XContainer 。
如需可以傳遞至此函式之有效內容的詳細資訊，請參閱 XElement 和 XDocument 物件的有效內容。
這個方法會引發 Changed 和 Changing 事件。
加入指定的內容，以當做此文件或項目的第一個子系。
public:
void AddFirst(System::Object ^ content);C#
public void AddFirst(object content);C#
public void AddFirst(object? content);member this.AddFirst : obj -> unitPublic Sub AddFirst (content As Object)參數
- content
- Object
要加入的包含簡單內容或內容物件集合的內容物件。
範例
下列範例會建立兩個 XML 樹狀結構，使用這個方法將 物件新增為其中一個 XElement 元素。 它也會將 LINQ 查詢的結果新增至 XML 樹狀結構。
C#
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.AddFirst(new XElement("NewChild", "new content"));
xmlTree.AddFirst(
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.AddFirst(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.AddFirst(New XElement("NewChild", "new content"))
xmlTree.AddFirst( _
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.AddFirst(srcTree.<Child9>)
Console.WriteLine(xmlTree)
這個範例會產生下列輸出：
XML
<Root>
<Element4>4</Element4>
<Element5>5</Element5>
<NewChild>new content</NewChild>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
備註
這個方法會在 的現有內容之前加入新的內容 XContainer 。
如需可以傳遞至此函式之有效內容的詳細資訊，請參閱 XElement 和 XDocument 物件的有效內容。
這個方法會引發 Changed 和 Changing 事件。
另請參閱
適用於
.NET 10 和其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
加入指定的內容，以當做此文件或項目的第一個子系。
public:
void AddFirst(... cli::array <System::Object ^> ^ content);C#
public void AddFirst(params object[] content);C#
public void AddFirst(params object?[] content);member this.AddFirst : obj[] -> unitPublic Sub AddFirst (ParamArray content As Object())參數
- content
- Object[]
內容物件的參數清單。
例外狀況
該父代為 null。
範例
下列範例會建立兩個 XML 樹狀結構，並使用這個方法將物件新增為其中一個 XElement 元素。 它也會將 LINQ 查詢的結果新增至 XML 樹狀結構。
C#
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.AddFirst(new XElement("NewChild", "new content"));
xmlTree.AddFirst(
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.AddFirst(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.AddFirst(New XElement("NewChild", "new content"))
xmlTree.AddFirst( _
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.AddFirst(srcTree.<Child9>)
Console.WriteLine(xmlTree)
這個範例會產生下列輸出：
XML
<Root>
<Element4>4</Element4>
<Element5>5</Element5>
<NewChild>new content</NewChild>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
備註
這個方法會在 的現有內容之前加入新的內容 XContainer 。
如需可以傳遞至此函式之有效內容的詳細資訊，請參閱 XElement 和 XDocument 物件的有效內容。
這個方法會引發 Changed 和 Changing 事件。
另請參閱
適用於
.NET 10 和其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
