Método XMLNodes.Add

Artigo
05/21/2013

Obtém um objeto de Microsoft.Office.Interop.Word.XMLNode que representa um elemento adicionado.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

XMLNode Add(
    string Name,
    string Namespace,
    ref Object Range
)

Parâmetros

Name
Tipo: System.String
O nome do elemento no esquema XML designado no parâmetro de Namespace .Como o XML diferencia maiúsculas de minúsculas, a ortografia do elemento especificado no parâmetro de Name deve ser exatamente como aparece no esquema.Se não coincide com qualquer um dos nomes de elementos no esquema especificado no parâmetro de Namespace , um erro é exibido.

Namespace
Tipo: System.String
O nome de esquema conforme definido no esquema.O parâmetro de Namespace diferencia maiúsculas de minúsculas e deve ser escrito exatamente como aparece no esquema.Se o namespace especificado não pode ser encontrada em qualquer um dos esquemas anexados ao documento, um erro é exibido.

Range
Tipo: System.Object%
O intervalo para que você deseja aplicar o elemento.O padrão é colocar as marcas do elemento no ponto de inserção ou ao redor de seleção se um texto é selecionado.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.XMLNode
Um objeto de Microsoft.Office.Interop.Word.XMLNode que representa um elemento adicionado.

Comentários

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir demonstra manipuladores de eventos para os eventos de AfterInsert e de BeforeDelete .O código exibe uma caixa de mensagem antes que Microsoft.Office.Interop.Word.XMLNode seja excluído do documento e depois Microsoft.Office.Interop.Word.XMLNode é adicionado ao documento.O exemplo também usa o método de Add para adicionar um novo elemento a uma coleção de XMLNodes em um intervalo especificado e disparar o evento por meio de AfterInsert .Este exemplo assume que o documento atual contém uma coleção de XMLNodes chamada SampleInsertNodes, que tem XMLNode pai chamado 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.");
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

XMLNodes Interface

Namespace Microsoft.Office.Tools.Word

Partilhar via