XMLNodes.Add 方法

  • 项目

获取一个表示新添加的元素的 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 命名空间