Menambahkan bagian XML kustom ke dokumen dengan menggunakan Add-in VSTO

Anda bisa menyimpan data XML dalam tipe dokumen berikut dengan membuat bagian XML kustom di Add-in VSTO:

• Buku kerja Microsoft Office Excel.

• Dokumen Microsoft Office Word.

• Presentasi Microsoft Office PowerPoint.

  Untuk informasi selengkapnya, lihat Gambaran umum bagian XML Kustom.

  Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat aplikasi untuk Excel, PowerPoint, dan Word. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Untuk menambahkan bagian XML kustom ke buku kerja Excel

1. Tambahkan objek baru CustomXMLPart ke CustomXMLParts koleksi dalam buku kerja. CustomXMLPart berisi string XML yang ingin Anda simpan dalam buku kerja.

   Contoh kode berikut menambahkan bagian XML kustom ke buku kerja tertentu.

   C#

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

   VB

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

2. AddCustomXmlPartToWorkbook Tambahkan metode ke ThisAddIn kelas dalam proyek Add-in VSTO untuk Excel.

3. Panggil metode dari kode lain dalam proyek Anda. Misalnya, untuk membuat bagian XML kustom saat pengguna membuka buku kerja, panggil metode dari penanganan aktivitas untuk peristiwa tersebut WorkbookOpen .

Untuk menambahkan bagian XML kustom ke dokumen Word

1. Tambahkan objek baru CustomXMLPart ke CustomXMLParts koleksi dalam dokumen. CustomXMLPart berisi string XML yang ingin Anda simpan dalam dokumen.

   Contoh kode berikut menambahkan bagian XML kustom ke dokumen tertentu.

   C#

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

   VB

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

2. AddCustomXmlPartToDocument Tambahkan metode ke ThisAddIn kelas dalam proyek Add-in VSTO untuk Word.

3. Panggil metode dari kode lain dalam proyek Anda. Misalnya, untuk membuat bagian XML kustom saat pengguna membuka dokumen, panggil metode dari penanganan aktivitas untuk peristiwa tersebut DocumentOpen .

Untuk menambahkan bagian XML kustom ke presentasi PowerPoint

1. Tambahkan objek baru CustomXMLPart ke koleksi Microsoft.Office.Interop.PowerPoint._Presentation.CustomXMLParts dalam presentasi. CustomXMLPart berisi string XML yang ingin Anda simpan dalam presentasi.

   Contoh kode berikut menambahkan bagian XML kustom ke presentasi tertentu.

   C#

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

   VB

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

2. AddCustomXmlPartToPresentation Tambahkan metode ke ThisAddIn kelas dalam proyek Add-in VSTO untuk PowerPoint.

3. Panggil metode dari kode lain dalam proyek Anda. Misalnya, untuk membuat bagian XML kustom saat pengguna membuka presentasi, panggil metode dari penanganan aktivitas untuk peristiwa Microsoft.Office.Interop.PowerPoint.EApplication_Event.AfterPresentationBuka .

Pemrograman yang kuat

Untuk kesederhanaan, contoh ini menggunakan string XML yang didefinisikan sebagai variabel lokal dalam metode . Biasanya, Anda harus mendapatkan XML dari sumber eksternal, seperti file atau database.

Konten terkait

• Gambaran umum bagian XML kustom
• Cara: Menambahkan bagian XML kustom ke kustomisasi tingkat dokumen