XMLNodes.Add - метод

Статья
08/11/2011

Возвращает объект 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
Имя элемента в схеме XML, указанной в параметре Namespace.Поскольку в языке 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. В данном примере предполагается, что текущий документ содержит коллекцию XMLNodes с именем SampleInsertNodes и родительским объектом XMLNode с именем SampleNode.

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 - пространство имен

Поделиться через