Практическое руководство. Добавление пользовательских XML-частей в настройках уровня документа

Статья
04/28/2010

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

Применимость
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Версия Microsoft Office Excel 2007 Word 2007 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office.

Тип проекта

Проекты уровня документа

Версия Microsoft Office

Excel 2007
Word 2007

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

XML-данные можно хранить в книге Microsoft Office Excel или документе Microsoft Office Word путем создания пользовательской XML-части в настройке уровня документа. Дополнительные сведения см. в разделе Общие сведения о пользовательских XML-частях.

Примечание.
Объект Visual Studio Tools for Office не предоставляет проекты уровня документа для Microsoft Office PowerPoint. Сведения о добавлении пользовательской XML-части в презентацию PowerPoint с использованием надстройки уровня приложения см. в разделе Практическое руководство. Добавление пользовательских XML-частей в документы с использованием надстроек уровня приложения.

Объект Visual Studio Tools for Office не предоставляет проекты уровня документа для Microsoft Office PowerPoint. Сведения о добавлении пользовательской XML-части в презентацию PowerPoint с использованием надстройки уровня приложения см. в разделе Практическое руководство. Добавление пользовательских XML-частей в документы с использованием надстроек уровня приложения.

Добавление пользовательской XML-части в книгу Excel

Добавьте новый объект Microsoft.Office.Core.CustomXMLPart в коллекцию Microsoft.Office.Core.CustomXMLParts рабочей книги. Объект Microsoft.Office.Core.CustomXMLPart содержит XML-строку, которую следует сохранить в книге.

Private Sub AddCustomXmlPartToWorkbook()
    Dim xmlString As String = _
        "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
            "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                "<employee>" & _
                    "<name>Karina Leal</name>" & _
                    "<hireDate>1999-04-01</hireDate>" & _
                    "<title>Manager</title>" & _
                "</employee>" & _
            "</employees>"
    Dim employeeXMLPart As Office.CustomXMLPart = Me.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToWorkbook()
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" +
            "<employee>" +
                "<name>Karina Leal</name>" +
                "<hireDate>1999-04-01</hireDate>" +
                "<title>Manager</title>" +
            "</employee>" +
        "</employees>";

    Office.CustomXMLPart employeeXMLPart = this.CustomXMLParts.Add(xmlString, missing);
}

Добавьте метод AddCustomXmlPartToWorkbook в класс ThisWorkbook проекта уровня документа для Excel 2007.
Вызовите метод из другого кода проекта. Например, для создания пользовательской XML-части при открытии книги вызовите метод из обработчика событий ThisWorkbook_Startup.

Добавление пользовательской XML-части в документ Word.

Добавьте новый объект Microsoft.Office.Core.CustomXMLPart в коллекцию Microsoft.Office.Core.CustomXMLParts документа. Объект Microsoft.Office.Core.CustomXMLPart содержит XML-строку, которую следует сохранить в документе.

Private Sub AddCustomXmlPartToDocument()
    Dim xmlString As String = _
        "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
            "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                "<employee>" & _
                    "<name>Karina Leal</name>" & _
                    "<hireDate>1999-04-01</hireDate>" & _
                    "<title>Manager</title>" & _
                "</employee>" & _
            "</employees>"

    Dim employeeXMLPart As Office.CustomXMLPart = _
        Me.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToDocument()
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" +
            "<employee>" +
                "<name>Karina Leal</name>" +
                "<hireDate>1999-04-01</hireDate>" +
                "<title>Manager</title>" +
            "</employee>" +
        "</employees>";

    Office.CustomXMLPart employeeXMLPart = this.CustomXMLParts.Add(xmlString, missing);
}

Добавьте метод AddCustomXmlPartToDocument в класс ThisDocument проекта на уровне документа для Word 2007.
Вызовите метод из другого кода проекта. Например, для создания пользовательской XML-части при открытии документа вызовите метод из обработчика событий ThisDocument_Startup.

Отказоустойчивость

Для простоты этот пример использует XML-строку, определенную в качестве локальной переменной метода. Обычно следует получать XML из такого внешнего источника, как файл или база данных.

См. также

Задачи

Практическое руководство. Добавление пользовательских XML-частей в документы с использованием надстроек уровня приложения

Практическое руководство. Добавление XML-частей в документ без запуска Microsoft Office

Основные понятия

Общие сведения о пользовательских XML-частях

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