Metodo XMLNodes.Add

Articolo
08/11/2011

Ottiene un oggetto Microsoft.Office.Interop.Word.XMLNode che rappresenta un elemento appena aggiunto.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

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

Parametri

Name
Tipo: System.String
Nome dell'elemento dello schema XML designato nel parametro Namespace.Poiché in XML viene fatta distinzione tra maiuscole e minuscole, l'ortografia dell'elemento specificato nel parametro Name deve essere esattamente come viene visualizzata nello schema.Se non corrisponde ad alcuno dei nomi dell'elemento presenti nello schema specificato nel parametro Namespace, verrà visualizzato un errore.

Namespace
Tipo: System.String
Nome dello schema come definito nello schema.Il parametro Namespace fa distinzione tra maiuscole e minuscole e deve essere digitato esattamente come viene visualizzato nello schema.Se non è possibile trovare lo spazio dei nomi specificato in alcuno degli schemi collegati al documento, verrà visualizzato un errore.

Range
Tipo: System.Object%
Intervallo cui si desidera applicare l'elemento.L'impostazione predefinita consiste nel posizionare i tag dell'elemento in corrispondenza del punto di inserimento o attorno alla selezione, se è selezionato un testo.

Valore restituito

Tipo: Microsoft.Office.Interop.Word.XMLNode
Oggetto Microsoft.Office.Interop.Word.XMLNode che rappresenta un elemento appena aggiunto.

Note

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente vengono illustrati i gestori eventi per gli eventi AfterInsert e BeforeDelete. Viene visualizzata una finestra di messaggio prima dell'eliminazione di un oggetto Microsoft.Office.Interop.Word.XMLNode dal documento e dopo l'aggiunta di un oggetto Microsoft.Office.Interop.Word.XMLNode al documento. Viene inoltre utilizzato il metodo Add per aggiungere un nuovo elemento a un insieme XMLNodes nell'intervallo specificato e generare l'evento AfterInsert a livello di codice. In questo esempio si suppone che il documento corrente contenga un insieme XMLNodes denominato SampleInsertNodes con un oggetto XMLNode padre denominato 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.");
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

XMLNodes Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Share via