XMLNodes.Add(String, String, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft ein XMLNode-Objekt ab, das ein neu hinzugefügtes Element darstellt.

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

Parameter

Name: String

Der Name des Elements im XML-Schema, das Namespace im -Parameter festgelegt ist. Da bei XML die Groß-/Kleinschreibung beachtet wird, muss die Schreibweise des im Name -Parameter angegebenen Elements genau so sein, wie sie im Schema angezeigt wird. Wenn er mit keinem der Elementnamen im im Namespace -Parameter angegebenen Schema übereinstimmt, wird ein Fehler angezeigt.

Namespace: String

Der wie im Schema definierte Name des Schemas. Beim Namespace Parameter wird die Groß-/Kleinschreibung beachtet und muss genau so geschrieben werden, wie er im Schema angezeigt wird. Wenn der angegebene Namespace in keinem der an das Dokument angefügten Schemas gefunden werden kann, wird ein Fehler angezeigt.

Range: 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.

Gibt zurück

XMLNode

Ein XMLNode-Objekt, das ein neu hinzugefügtes Element darstellt.

Beispiele

Im folgenden Codebeispiel werden Ereignishandler für die AfterInsert Ereignisse und BeforeDelete veranschaulicht. Der Code zeigt ein Meldungsfeld an, bevor ein Microsoft.Office.Interop.Word.XMLNode aus dem Dokument gelöscht wird und nachdem dem Dokument eine Microsoft.Office.Interop.Word.XMLNode hinzugefügt wurde. Im Beispiel wird auch die Add -Methode verwendet, um einer XMLNodes Auflistung in einem angegebenen Bereich ein neues Element hinzuzufügen und das AfterInsert Ereignis programmgesteuert auszulösen. In diesem Beispiel wird davon ausgegangen, dass das aktuelle Dokument eine XMLNodes Auflistung mit dem Namen SampleInsertNodesenthält, die über ein übergeordnetes XMLNode Element namens verfügt 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

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über