Bookmark.InsertXML, méthode

Article
01/06/2014

Insère le texte XML spécifié dans le contrôle Bookmark.

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

Syntaxe

'Déclaration
Sub InsertXML ( _
    XML As String, _
    ByRef Transform As Object _
)

void InsertXML(
    string XML,
    ref Object Transform
)

Paramètres

XML
Type : System.String
Texte XML à insérer.

Transform
Type : System.Object%
Transformation à appliquer au texte XML inséré.

Notes

Si le contrôle Bookmark contient du texte, la méthode InsertXML remplace le texte existant.

L'appel de cette méthode peut supprimer le contrôle Bookmark.

Utilisez la méthode InsertXML pour insérer le texte marqué avec un XML arbitraire ou un XML Word. Le code XML doit être correct. S'il utilise un XML Word, il doit également être en concordance avec le schéma XML de Word.

Si le texte XML spécifié ne peut pas être inséré dans le contrôle Bookmark, un message d'erreur est affiché.

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 ajoute un contrôle Bookmark au document, puis insère un texte XML dans le signet. Ensuite, un message affiche le nombre total de XMLNodes et le contenu XML du signet.

Cet exemple illustre une personnalisation au niveau du document.

Private Sub BookmarkInsertXML()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "Sample of bookmark text."
    Bookmark1.Words(1).InsertXML( _
        "<example>This is an example.</example>")
    MessageBox.Show("Total XMLNodes in Bookmark1: " & _
        Bookmark1.XMLNodes.Count.ToString & vbLf & vbLf & _
        "XML contents: " & Bookmark1.XML(True))

End Sub

private void BookmarkInsertXML()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "Sample of bookmark text.";

    bookmark1.Words[1].InsertXML("<example>This is an example.</example>",
        ref missing);

    MessageBox.Show("Total XMLNodes in bookmark1: " + bookmark1.XMLNodes.Count +
        "\n" + "XML contents: " + bookmark1.XML[true]);
}

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

Bookmark Interface

Microsoft.Office.Tools.Word, espace de noms

Partager via