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, представляющий вновь добавленный элемент.

Примеры

В следующем примере кода показаны обработчики событий для AfterInsert событий и BeforeDelete . Код отображает окно сообщения перед удалением Microsoft.Office.Interop.Word.XMLNode из документа и после Microsoft.Office.Interop.Word.XMLNode добавления в документ. В примере также используется Add метод для добавления нового элемента в коллекцию XMLNodes в указанном диапазоне и программного AfterInsert вызова события. В этом примере предполагается, что текущий документ содержит коллекцию XMLNodes с именем SampleInsertNodes, которая имеет родительский XMLNode объект с именем SampleNode.

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.