XMLNodes.Add 메서드

아티클
08/10/2011

새로 추가된 요소를 나타내는 Microsoft.Office.Interop.Word.XMLNode 개체를 가져옵니다.

네임스페이스: Microsoft.Office.Tools.Word
어셈블리: Microsoft.Office.Tools.Word(Microsoft.Office.Tools.Word.dll)

구문

‘선언
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

XMLNode Add(
    string Name,
    string Namespace,
    ref Object Range
)

매개 변수

Name
형식: System.String
Namespace 매개 변수에 지정된 XML 스키마의 요소 이름입니다.XML은 대/소문자를 구분하므로 Name 매개 변수에 지정된 요소는 스키마에 나타난 요소와 철자가 정확히 일치해야 합니다.이것이 Namespace 매개 변수에 지정된 스키마의 요소 이름과 일치하지 않으면 오류가 표시됩니다.

Namespace
형식: System.String
스키마에 정의된 스키마 이름입니다.Namespace 매개 변수는 대/소문자를 구분하므로 스키마에 나타난 요소와 철자가 정확히 일치해야 합니다.문서에 연결된 스키마에 지정된 네임스페이스가 없으면 오류가 표시됩니다.

Range
형식: System.Object%
요소를 적용할 범위입니다.기본적으로 요소 태그를 삽입 지점에 배치하거나, 텍스트가 선택된 경우 선택 영역 주위에 배치합니다.

반환 값

형식: Microsoft.Office.Interop.Word.XMLNode
새로 추가된 요소를 나타내는 Microsoft.Office.Interop.Word.XMLNode 개체입니다.

설명

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.

예제

다음 코드 예제에서는 AfterInsert 및 BeforeDelete 이벤트의 이벤트 처리기를 보여 줍니다. 코드에서는 Microsoft.Office.Interop.Word.XMLNode가 문서에서 삭제되기 전과 Microsoft.Office.Interop.Word.XMLNode가 문서에 추가된 후 메시지 상자를 표시합니다. 예제에서는 또한 Add 메서드를 사용하여 새 요소를 XMLNodes 컬렉션의 지정된 범위에 추가하고 프로그래밍 방식으로 AfterInsert 이벤트를 발생시킵니다. 이 예제에서는 현재 문서에 SampleInsertNodes라는 XMLNodes 컬렉션이 있고, 이 컬렉션에는 SampleNode라는 부모 XMLNode가 있다고 가정합니다.

Private Sub XMLNodeAddAndDelete()
    Dim range1 As Object = Me.SampleInsertNodes(1).Range

    ' This will raise the AfterInsert event.
    Dim node1 As Word.XMLNode = _
        Me.SampleInsertNodes.Add("MemoFrom", _
        Me.SampleNode.NamespaceURI, range1)
End Sub

Private Sub SampleInsertNodes_AfterInsert(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs)


    If e.InUndoRedo Then
        MessageBox.Show("A child element of SampleInsertNodes was " & _
            "inserted as a result of an undo or redo operation.")
    Else
        MessageBox.Show("A child element of SampleInsertNodes " & _
            "was inserted.")
    End If
End Sub

Private Sub SampleInsertNodes_BeforeDelete(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs)


    If e.InUndoRedo Then
        MessageBox.Show("A child element of SampleInsertNodes " & _
            "is about to be deleted as a result of an undo or " & _
            "redo operation.")
    Else
        MessageBox.Show("A child element of SampleInsertNodes " & _
        "is about to be deleted.")
    End If
End Sub

private void XMLNodeAddAndDelete()
{
    object range1 = this.SampleInsertNodes[1].Range;

    this.SampleInsertNodes.AfterInsert +=
        new Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventHandler(
        SampleInsertNodes_AfterInsert);

    this.SampleInsertNodes.BeforeDelete +=
        new Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventHandler(
        SampleInsertNodes_BeforeDelete);

    // This will raise the AfterInsert event.
    Word.XMLNode node1 = this.SampleInsertNodes.Add("MemoFrom",
        this.SampleNode.NamespaceURI, ref range1);
}

void SampleInsertNodes_AfterInsert(object sender,
    Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs e)
{
    if (e.InUndoRedo)
    {
        MessageBox.Show("A child element of SampleInsertNodes was " +
            "inserted as a result of an undo or redo operation.");
    }
    else
    {
        MessageBox.Show("A child element of SampleInsertNodes " +
            "was inserted.");
    }
}

void SampleInsertNodes_BeforeDelete(object sender,
    Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs e)
{
    if (e.InUndoRedo)
    {
        MessageBox.Show("A child element of SampleInsertNodes " +
            "is about to be deleted as a result of an undo or " +
            "redo operation.");
    }
    else
    {
        MessageBox.Show("A child element of SampleInsertNodes " +
            "is about to be deleted.");
    }
}

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

XMLNodes 인터페이스

Microsoft.Office.Tools.Word 네임스페이스

다음을 통해 공유