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

參數所 Namespace 指定之 XML 架構中的項目名稱。 因為 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 並以程序設計方式引發 事件。 本範例假設目前的檔包含XMLNodes名為 的集合，該集合具有名為 SampleInsertNodesSampleNode的父XMLNode系。

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 方案中的選擇性參數。