Método XMLNodes.Add

Artigo
08/01/2011

Obtém um Microsoft.Office.Interop.Word.XMLNode objeto que representa um elemento recém-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 do esquema XML designado no Namespace parâmetro.Porque o XML diferencia maiúsculas de minúsculas, a ortografia do elemento especificado no Name parâmetro deve ser exatamente como aparece no esquema.Se ele não corresponde a nenhum dos nomes de elementos do esquema especificado na Namespace parâmetro, um erro é exibido.

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

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

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode objeto que representa um elemento recém-adicionado.

Comentários

Optional Parameters

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

Exemplos

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

Compartilhar via