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 事件。 此示例假定当前文档包含名为 XMLNodes 的SampleInsertNodes集合，该集合具有名为 的SampleNode父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 解决方案中的可选参数。