Bookmark.InsertXML Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Вставляет в элемент управления Bookmark указанный текст XML.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Sub InsertXML ( _
    XML As String, _
    ByRef Transform As Object _
)
'Применение
Dim instance As Bookmark
Dim XML As String
Dim Transform As Object

instance.InsertXML(XML, Transform)

public void InsertXML(
    string XML,
    ref Object Transform
)

Параметры

XML
Тип: System.String
Вставляемый текст XML.

Transform
Тип: System.Object%
Преобразование, применяемое к вставленному тексту XML.

Заметки

Если элемент управления Bookmark содержит текст, метод InsertXML заменяет существующий текст.

В результате вызова этого метода элемент управления Bookmark может быть удален.

Метод InsertXML используется для вставки текста, размеченного либо с использованием произвольных XML-элементов, либо XML-элементов Word. Код XML должен быть правильным. При использовании XML-элементов Word код также должен быть правильным и соответствовать XML-схеме Word.

Если указанный текст XML не удастся вставить в элемент управления Bookmark, будет выведено сообщение об ошибке.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В приведенном ниже примере кода в документ добавляется элемент управления Bookmark, после чего в закладку вставляется текст XML. Затем в окне сообщения выводится общее количество узлов XMLNodes и XML-содержимое закладки.

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Поделиться через