XMLNodes.Add(String, String, Object) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Word

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient un objet XMLNode qui représente un élément récemment ajouté.

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

Paramètres

Name: String

Nom de l’élément dans le schéma XML désigné dans le Namespace paramètre . Étant donné que XML respecte la casse, l’orthographe de l’élément spécifié dans le Name paramètre doit être exactement telle qu’elle apparaît dans le schéma. S’il ne correspond à aucun des noms d’éléments dans le schéma spécifié dans le Namespace paramètre, une erreur s’affiche.

Namespace: String

Nom du schéma tel que défini dans le schéma. Le Namespace paramètre respecte la casse et doit être orthographié exactement comme il apparaît 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: 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é.

Retours

XMLNode

Objet XMLNode qui représente un élément récemment ajouté.

Exemples

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

Remarques

Paramètres facultatifs

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

S’applique à

Partager via