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

發行項
08/12/2011

您可以將 XML 資料儲存在下列類型的文件中，方法是在應用程式層級增益集中建立自訂 XML 組件：

Microsoft Office Excel 活頁簿。
Microsoft Office Word 文件。
Microsoft Office PowerPoint 簡報。

**適用於：**本主題中的資訊適用於下列應用程式的應用程式層級專案：Excel 2007 和 Excel 2010、PowerPoint 2007 和 PowerPoint 2010、Word 2007 和 Word 2010。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

若要將自訂 XML 組件加入至 Excel 活頁簿

將新的 CustomXMLPart 物件加入至活頁簿中的 CustomXMLParts 集合。 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 方法加入至 Excel 應用程式層級專案中的 ThisAddIn 類別。
從您的專案中其他程式碼呼叫方法。例如，若要在使用者開啟活頁簿時建立自訂 XML 組件，請從 WorkbookOpen 事件的事件處理常式呼叫方法。

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

將新的 CustomXMLPart 物件加入至文件中的 CustomXMLParts 集合。 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 方法加入至 Word 應用程式層級專案中的 ThisAddIn 類別。
從您的專案中其他程式碼呼叫方法。例如，若要在使用者開啟文件時建立自訂 XML 組件，請從 DocumentOpen 事件的事件處理常式呼叫方法。

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

將新的 CustomXMLPart 物件加入至簡報中的 CustomXMLParts 集合。 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 方法加入至 PowerPoint 應用程式層級專案中的 ThisAddIn 類別。
從您的專案中其他程式碼呼叫方法。例如，若要在使用者開啟簡報時建立自訂 XML 組件，請從 AfterPresentationOpen 事件的事件處理常式呼叫方法。