XMLNodes.Add(String, String, Object) 메서드

정의

네임스페이스:

Microsoft.Office.Tools.Word

어셈블리:

Microsoft.Office.Tools.Word.dll

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

public Microsoft.Office.Interop.Word.XMLNode Add (string Name, string Namespace, ref object Range);

abstract member Add : string * string * obj -> Microsoft.Office.Interop.Word.XMLNode

Public Function Add (Name As String, Namespace As String, Optional ByRef Range As Object) As XMLNode

매개 변수

Name

String

매개 변수에 지정된 XML 스키마의 Namespace 요소 이름입니다. XML은 대/소문자를 구분하므로 매개 변수에 Name 지정된 요소의 맞춤법은 스키마에 표시되는 것과 정확히 동일해야 합니다. 매개 변수에 지정된 Namespace 스키마의 요소 이름과 일치하지 않으면 오류가 표시됩니다.

Namespace

String

스키마에 정의된 스키마 이름입니다. 매개 변수는 Namespace 대/소문자를 구분하며 스키마에 표시되는 대로 정확하게 철자가 지정되어야 합니다. 문서에 연결된 스키마에 지정된 네임스페이스가 없으면 오류가 표시됩니다.

Range

Object

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

반환

XMLNode

새로 추가된 요소를 나타내는 XMLNode 개체입니다.

예제

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

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.");
    }
}

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

설명

선택적 매개 변수

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