將自訂 XML 組件新增至文件層級自訂

您可以在文件層級自訂中建立自訂 XML 組件，將 XML 資料儲存在 Microsoft Office Excel 活頁簿或 Microsoft Office Word 文件中。 如需詳細資訊，請參閱自訂 XML 組件概述。

適用對象：本主題資訊適用於 Excel 及 Word 的文件層級專案。 如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

注意

Visual Studio 不提供 Microsoft Office PowerPoint 的文件層級專案。 如需使用 VSTO 增益集將自訂 XML 組件新增至 PowerPoint 簡報的詳細資訊，請參閱如何：使用 VSTO 增益集將自訂 XML 組件新增至文件。

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

1. 將新的 CustomXMLPart 物件加入至活頁簿中的 CustomXMLParts 集合。 CustomXMLPart 包含您要儲存在活頁簿中的 XML 字串。

   C#

   private void AddCustomXmlPartToWorkbook()
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"http://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);
   }
   

   VB

   Private Sub AddCustomXmlPartToWorkbook()
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees xmlns=""http://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
   

2. 將 AddCustomXmlPartToWorkbook 方法加入 Excel 文件層級專案中的 ThisWorkbook 類別。

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

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

1. 將新的 CustomXMLPart 物件加入至文件中的 CustomXMLParts 集合。 CustomXMLPart 包含您要儲存在文件中的 XML 字串。

   C#

   private void AddCustomXmlPartToDocument()
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"http://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);
   }
   

   VB

   Private Sub AddCustomXmlPartToDocument()
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees xmlns=""http://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
   

2. 將 AddCustomXmlPartToDocument 方法加入 Word 文件層級專案中的 ThisDocument 類別。

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

穩固程式設計

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

相關內容

• 自訂 XML 組件概述
• 如何：使用 VSTO 增益集將自訂 XML 組件新增至文件