XMLNodes.Add, méthode

Obtient un objet Microsoft.Office.Interop.Word.XMLNode qui représente un élément récemment ajouté.

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

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

Paramètres

• Name
  Type : System.String
  Nom de l'élément dans le schéma XML désigné dans le paramètre Namespace.Parce que XML respecte la casse, l'orthographe de l'élément spécifié dans le paramètre Name doit être exactement telle qu'elle apparaît dans le schéma.S'il ne correspond pas à un des noms d'éléments dans le schéma spécifié dans le paramètre Namespace, une erreur est affichée.

• Namespace
  Type : System.String
  Nom du schéma tel que défini dans le schéma.Le paramètre Namespace respecte la casse et doit être orthographié exactement comme dans le schéma.Si l'espace de noms spécifié est introuvable dans un des schémas attachés au document, une erreur est affichée.

• Range
  Type : System.Object%
  Plage à laquelle vous souhaitez appliquer l'élément.Par défaut, les balises d'éléments sont placées au point d'insertion ou autour de la sélection si un texte est sélectionné.

Valeur de retour

Type : Microsoft.Office.Interop.Word.XMLNode
Objet Microsoft.Office.Interop.Word.XMLNode qui représente un élément récemment ajouté.

Notes

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant illustre les gestionnaires des événements AfterInsert et BeforeDelete. Le code affiche un message avant qu'un Microsoft.Office.Interop.Word.XMLNode ne soit supprimé du document et après qu'un Microsoft.Office.Interop.Word.XMLNode est ajouté au document. L'exemple utilise également la méthode Add pour ajouter un nouvel élément à une collection XMLNodes à une plage spécifiée et pour déclencher par programme l'événement AfterInsert. Cet exemple suppose que le document en cours contient une collection XMLNodes nommée SampleInsertNodes qui a un XMLNode parent nommé 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.");
    }
}

Sécurité .NET Framework

• Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

XMLNodes Interface

Microsoft.Office.Tools.Word, espace de noms