共用方式為

HOW TO：使用應用程式層級增益集將自訂 XML 組件加入至文件

  • 發行項

更新：2007 年 11 月

適用於

本主題中的資訊僅適用於指定的 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 活頁簿

  1. 將新的 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);
}

  2. 將 AddCustomXmlPartToWorkbook 方法加入至 Excel 2007 應用程式層級專案中的 ThisAddIn 類別。

  3. 從您的專案中其他程式碼呼叫方法。例如，若要在使用者開啟活頁簿時建立自訂 XML 組件，請從 Microsoft.Office.Interop.Excel.Application.WorkbookOpen 事件的事件處理常式呼叫方法。

若要將自訂 XML 組件加入至 Word 文件

  1. 將新的 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);
}

  2. 將 AddCustomXmlPartToDocument 方法加入至 Word 2007 應用程式層級專案中的 ThisAddIn 類別。

  3. 從您的專案中其他程式碼呼叫方法。例如，若要在使用者開啟文件時建立自訂 XML 組件，請從 Microsoft.Office.Interop.Word.Application.DocumentOpen 事件的事件處理常式呼叫方法。

若要將自訂 XML 組件加入至 PowerPoint 簡報

  1. 將新的 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);
}

  2. 將 AddCustomXmlPartToPresentation 方法加入至 PowerPoint 2007 應用程式層級專案中的 ThisAddIn 類別。

  3. 從您的專案中其他程式碼呼叫方法。例如，若要在使用者開啟簡報時建立自訂 XML 組件，請從 Microsoft.Office.Interop.PowerPoint.Application.AfterPresentationOpen 事件的事件處理常式呼叫方法。

穩固程式設計

為了簡化，這個範例使用定義為方法中區域變數的 XML 字串。通常，您應從外部來源取得 XML，例如檔案或資料庫。

請參閱

工作

HOW TO：將自訂 XML 組件加入至文件層級自訂

HOW TO：將自訂 XML 組件加入至文件而不啟動 Microsoft Office

概念

自訂 XML 組件概觀