Freigeben über


XMLNodes.Add-Methode

Ruft ein Microsoft.Office.Interop.Word.XMLNode-Objekt ab, das ein neu hinzugefügtes Element darstellt.

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

Syntax

'Declaration
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode
XMLNode Add(
    string Name,
    string Namespace,
    ref Object Range
)

Parameter

  • Name
    Typ: System.String
    Der Name des Elements im XML-Schema, der im Namespace-Parameter festgelegt ist.Da bei XML die Groß- und Kleinschreibung beachtet werden muss, muss die im Name-Parameter angegebene Schreibweise des Elements mit der Schreibweise im Schema identisch sein.Wenn sie nicht mit einem der Elementnamen im vom Namespace-Parameter angegebenen Schema übereinstimmt, wird ein Fehler angezeigt.
  • Namespace
    Typ: System.String
    Der wie im Schema definierte Name des Schemas.Beim Namespace-Parameter muss die Groß- und Kleinschreibung beachtet werden, und seine Schreibweise muss genau der Schreibweise im Schema entsprechen.Wenn der angegebene Namespace in keinem der an das Dokument angefügten Schemas gefunden werden kann, wird ein Fehler angezeigt.
  • Range
    Typ: System.Object%
    Der Bereich, auf den das Element angewendet werden soll.In der Standardvorgehensweise werden die Elementtags an der Einfügemarke oder in der Umgebung der Markierung platziert, falls Text markiert wurde.

Rückgabewert

Typ: Microsoft.Office.Interop.Word.XMLNode
Ein Microsoft.Office.Interop.Word.XMLNode-Objekt, das ein neu hinzugefügtes Element darstellt.

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel werden Ereignishandler für das AfterInsert-Ereignis und das BeforeDelete-Ereignis dargestellt. Der Code zeigt ein Meldungsfeld an, bevor ein Microsoft.Office.Interop.Word.XMLNode aus dem Dokument gelöscht wird und nachdem dem Dokument ein Microsoft.Office.Interop.Word.XMLNode hinzugefügt wurde. In dem Beispiel wird auch die Add-Methode verwendet, um einer XMLNodes-Auflistung in einem bestimmten Bereich ein neues Element hinzuzufügen und programmgesteuert ein AfterInsert-Ereignis auszulösen. In diesem Beispiel wird davon ausgegangen, dass das aktuelle Dokument ein XMLNodes mit dem Namen SampleInsertNodes enthält, das über einen übergeordneten XMLNode mit dem Namen SampleNode verfügt.

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-Sicherheit

Siehe auch

Referenz

XMLNodes Schnittstelle

Microsoft.Office.Tools.Word-Namespace