Bookmark.InsertXML - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Sub InsertXML ( _
    XML As String, _
    ByRef Transform As Object _
)

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

Bookmark Интерфейс

Microsoft.Office.Tools.Word - пространство имен

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