Freigeben über


Bookmark.InsertXML-Methode

Fügt den angegebenen XML-Text in das Bookmark-Steuerelement ein.

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

Syntax

'Declaration
Sub InsertXML ( _
    XML As String, _
    ByRef Transform As Object _
)
void InsertXML(
    string XML,
    ref Object Transform
)

Parameter

  • Transform
    Typ: System.Object%
    Die auf den eingefügten XML-Text anzuwendende Transformation.

Hinweise

Wenn das Bookmark-Steuerelement Text enthält, ersetzt die InsertXML-Methode den vorhandenen Text.

Durch Aufrufen dieser Methode wird möglicherweise das Bookmark-Steuerelement gelöscht.

Verwenden Sie die InsertXML-Methode zum Einfügen von mit beliebigem XML oder Word-XML bearbeitetem Text. Der XML-Code muss wohlgeformt sein. Wenn Word-XML verwendet wird, muss dies gültig entsprechend des Word-XML-Schemas sein.

Wenn der angegebene XML-Text nicht in das Bookmark-Steuerelement eingefügt werden kann, wird eine Fehlermeldung angezeigt.

Optionale Parameter

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

Beispiele

Im folgenden Codebeispiel wird dem Dokument ein Bookmark-Steuerelement hinzugefügt und anschließend XML-Text in das Lesezeichen eingefügt. In einem Meldungsfeld wird dann die Gesamtanzahl der XMLNodes und der XML-Inhalt des Lesezeichens angezeigt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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]);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace