XMLNodes.Add(String, String, Object) Metodo

Definizione

Spazio dei nomi:

Microsoft.Office.Tools.Word

Assembly:

Microsoft.Office.Tools.Word.dll

Ottiene un oggetto XMLNode che rappresenta un elemento appena aggiunto.

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

Parametri

Name

String

Nome dell'elemento nello schema XML designato nel Namespace parametro . Poiché XML è distinzione tra maiuscole e minuscole, l'ortografia dell'elemento specificato nel Name parametro deve essere esattamente come viene visualizzata nello schema. Se non corrisponde a uno dei nomi degli elementi nello schema specificato nel Namespace parametro, viene visualizzato un errore.

Namespace

String

Nome dello schema come definito nello schema. Il Namespace parametro è distinzione tra maiuscole e minuscole e deve essere ortografico 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

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.

Restituisce

XMLNode

Oggetto XMLNode che rappresenta un elemento appena aggiunto.

Esempio

Nell'esempio di codice seguente vengono illustrati i gestori eventi per gli AfterInsert eventi e BeforeDelete . Il codice visualizza una finestra di messaggio prima che venga Microsoft.Office.Interop.Word.XMLNode eliminata dal documento e dopo l'aggiunta di un Microsoft.Office.Interop.Word.XMLNode oggetto al documento. L'esempio usa anche il Add metodo per aggiungere un nuovo elemento a una XMLNodes raccolta in un intervallo specificato e generare a livello di codice l'evento AfterInsert . In questo esempio si presuppone che il documento corrente contenga una XMLNodes raccolta denominata SampleInsertNodes, che ha un elemento padre XMLNode denominato 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

Commenti

Parametri facoltativi

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