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

Статья
04/28/2010

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

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

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

Тип проекта

Проекты уровня приложения

Версия Microsoft Office

Excel 2007
PowerPoint 2007
Word 2007

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

Можно сохранить XML-данные с помощью создания пользовательских XML-частей в надстройках уровня приложения в следующих типах документов:

книга Microsoft Office Excel;
документ Microsoft Office Word;
презентация Microsoft Office PowerPoint.

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

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

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

Следующий пример кода добавляет пользовательскую XML-часть в указанную книгу.

Private Sub AddCustomXmlPartToWorkbook(ByVal workbook As Excel.Workbook)
    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 = _
        workbook.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToWorkbook(Excel.Workbook workbook)
{
    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 = workbook.CustomXMLParts.Add(xmlString, missing);
}

Добавьте метод AddCustomXmlPartToWorkbook в класс ThisAddIn проекта уровня документа для Excel 2007.
Вызовите этот метод из другого кода проекта. Например, для создания пользовательской XML-части при открытии книги вызовите метод из обработчика событий для события Microsoft.Office.Interop.Excel.Application.WorkbookOpen.

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

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

Следующий пример кода добавляет пользовательскую XML-часть в указанный документ.

Private Sub AddCustomXmlPartToActiveDocument(ByVal document As Word.Document)
    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 = _
        document.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToActiveDocument(Word.Document document)
{
    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 = document.CustomXMLParts.Add(xmlString, missing);
}

Добавьте метод AddCustomXmlPartToDocument в класс ThisAddIn проекта уровня документа для Word 2007.
Вызовите этот метод из другого кода проекта. Например, для создания пользовательской XML-части при открытии документа вызовите метод из обработчика событий для события Microsoft.Office.Interop.Word.Application.DocumentOpen.

Добавление пользовательской XML-части в презентацию PowerPoint

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

Следующий пример кода добавляет пользовательскую XML-часть в указанную презентацию.

Private Sub AddCustomXmlPartToPresentation(ByVal presentation As PowerPoint.Presentation)
    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 = _
        presentation.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToPresentation(PowerPoint.Presentation presentation)
{
    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 = 
        presentation.CustomXMLParts.Add(xmlString, missing);
}

Добавьте метод AddCustomXmlPartToPresentation в класс ThisAddIn проекта уровня документа для PowerPoint 2007.
Вызовите этот метод из другого кода проекта. Например, для создания пользовательской XML-части при открытии презентации вызовите метод из обработчика событий для события Microsoft.Office.Interop.PowerPoint.Application.AfterPresentationOpen.

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

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

См. также

Задачи

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

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

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

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

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