XContainer.AddFirst 메서드

정의

네임스페이스:

System.Xml.Linq

어셈블리:

netstandard.dll, System.Xml.XDocument.dll

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.

오버로드

Name	Description
AddFirst(Object)	지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.
AddFirst(Object[])	지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.

예제

다음 예제에서는 두 개의 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.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)

이 예제는 다음과 같은 출력을 생성합니다.

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

설명

이 메서드는 의 기존 콘텐츠 앞에 새 콘텐츠를 추가합니다 XContainer.

이 함수에 전달할 수 있는 유효한 콘텐츠에 대한 자세한 내용은 XElement 및 XDocument 개체의 유효한 콘텐츠를 참조하세요.

이 메서드는 및 이벤트를 발생 Changed 시킬 Changing 것입니다.

AddFirst(Object)

Source:

XContainer.cs

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.

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

public void AddFirst(object? content);

member this.AddFirst : obj -> unit

Public Sub AddFirst (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.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)

이 예제는 다음과 같은 출력을 생성합니다.

<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 것입니다.

추가 정보

• Add
• RemoveNodes()
• ReplaceNodes
• LINQ to XML 개요

AddFirst(Object[])

Source:

XContainer.cs

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.

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

public void AddFirst(params object?[] content);

member this.AddFirst : obj[] -> unit

Public Sub AddFirst (ParamArray content As Object())

매개 변수

content

Object[]

콘텐츠 개체의 매개 변수 목록입니다.

예외

InvalidOperationException

부모 노드가 null인 경우

예제

다음 예제에서는 두 개의 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.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)

이 예제는 다음과 같은 출력을 생성합니다.

<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 것입니다.

추가 정보

• Add
• RemoveNodes()
• ReplaceNodes
• LINQ to XML 개요