XContainer.AddFirst 메서드

정의

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.Adds the specified content as the first children of this document or element.

오버로드

AddFirst(Object)

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.Adds the specified content as the first children of this document or element.

AddFirst(Object[])

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.Adds the specified content as the first children of this document or element.

예제

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

기존 내용 앞에 새 콘텐츠를 추가 하는이 메서드는 XContainer합니다.This method adds the new content before the existing content of the XContainer.

이 함수에 전달 될 수 있는 유효한 콘텐츠에 대 한 자세한 내용은 참조 하세요 유효한 콘텐츠 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.

AddFirst(Object)

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.Adds the specified content as the first children of this document or element.

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

매개 변수

content
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, uses this method to add an XElement object as the first element 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.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)  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

<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합니다.This method adds the new content before the existing content of the XContainer.

이 함수에 전달 될 수 있는 유효한 콘텐츠에 대 한 자세한 내용은 참조 하세요 유효한 콘텐츠 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.

추가 정보

AddFirst(Object[])

지정된 콘텐츠를 이 문서 또는 요소의 첫 번째 자식으로 추가합니다.Adds the specified content as the first children of this document or element.

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[]

콘텐츠 개체의 매개 변수 목록입니다.A parameter list of content objects.

예외

부모 노드가 null인 경우The parent is null.

예제

다음 예제에서는 두 XML 트리를 만들고이 메서드를 사용 하 여 추가 XElement 하나에 첫 번째 요소로 개체입니다.The following example creates two XML trees, and uses this method to add an XElement object as the first element 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.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)  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

<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합니다.This method adds the new content before the existing content of the XContainer.

이 함수에 전달 될 수 있는 유효한 콘텐츠에 대 한 자세한 내용은 참조 하세요 유효한 콘텐츠 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.

추가 정보

적용 대상