Bookmark.InsertXML-Methode

Artikel
08/10/2011

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

XML
Typ: System.String
Der einzufügende XML-Text.

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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über