Dodawanie niestandardowych części XML do dostosowań na poziomie dokumentu

Dane XML można przechowywać w skoroszycie programu Microsoft Office Excel lub dokumencie programu Microsoft Office Word, tworząc niestandardową część XML w dostosowywaniu na poziomie dokumentu. Aby uzyskać więcej informacji, zobacz Omówienie niestandardowych części XML.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu dla programów Excel i Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Uwaga

Program Visual Studio nie udostępnia projektów na poziomie dokumentu dla programu Microsoft Office PowerPoint. Aby uzyskać informacje na temat dodawania niestandardowej części XML do prezentacji programu PowerPoint przy użyciu dodatku VSTO, zobacz How to: Add custom XML parts to documents by using VSTO Add-ins (Instrukcje: dodawanie niestandardowych części XML do dokumentów przy użyciu dodatków VSTO).

Aby dodać niestandardową część XML do skoroszytu programu Excel

1. Dodaj nowy CustomXMLPart obiekt do CustomXMLParts kolekcji w skoroszycie. Zawiera CustomXMLPart ciąg XML, który ma być przechowywany w skoroszycie.

   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. Dodaj metodę AddCustomXmlPartToWorkbookThisWorkbook do klasy w projekcie na poziomie dokumentu dla programu Excel.

3. Wywołaj metodę z innego kodu w projekcie. Aby na przykład utworzyć niestandardową część XML po otwarciu skoroszytu przez użytkownika, wywołaj metodę z ThisWorkbook_Startup procedury obsługi zdarzeń.

Aby dodać niestandardową część XML do dokumentu programu Word

1. Dodaj nowy CustomXMLPart obiekt do CustomXMLParts kolekcji w dokumencie. Zawiera CustomXMLPart ciąg XML, który ma być przechowywany w dokumencie.

   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. Dodaj metodę AddCustomXmlPartToDocument do ThisDocument klasy w projekcie na poziomie dokumentu dla programu Word.

3. Wywołaj metodę z innego kodu w projekcie. Aby na przykład utworzyć niestandardową część XML po otwarciu dokumentu przez użytkownika, wywołaj metodę z ThisDocument_Startup procedury obsługi zdarzeń.

Niezawodne programowanie

Dla uproszczenia w tym przykładzie użyto ciągu XML zdefiniowanego jako zmienna lokalna w metodzie . Zazwyczaj należy uzyskać kod XML ze źródła zewnętrznego, takiego jak plik lub baza danych.

Powiązana zawartość

• Omówienie niestandardowych części XML
• Instrukcje: dodawanie niestandardowych części XML do dokumentów przy użyciu dodatków VSTO