Udostępnij za pośrednictwem


Jak: Dodawanie składników XML niestandardowe do dostosowania na poziomie dokumentu

Tworząc niestandardowa część kodu XML w dostosowania poziomu dokumentu, można przechowywać danych XML w skoroszycie programu Microsoft Office Excel lub dokumentu programu Microsoft Office Word.Aby uzyskać więcej informacji, zobacz Przegląd części XML niestandardowych.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie dokumentu dla następujących aplikacji: Excel 2013 i Excel 2010; Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.

[!UWAGA]

Visual Studio nie zapewnia projektów na poziomie dokumentu dla programu Microsoft Office PowerPoint.Uzyskać informacje o dodawaniu niestandardowa część kodu XML do prezentacji programu PowerPoint przy użyciu dodatku poziomie aplikacji, zobacz Jak: dodawanie części XML niestandardowe do dokumentów przy użyciu dodatków poziomie aplikacji.

Aby dodać niestandardowe części XML do skoroszytu programu Excel

  1. Dodaj nowy CustomXMLPart obiekt do CustomXMLParts kolekcji w skoroszycie.CustomXMLPart Zawiera ciąg XML, które mają być przechowywane w skoroszycie.

    Private Sub AddCustomXmlPartToWorkbook()
        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 = Me.CustomXMLParts.Add(xmlString)
    End Sub
    
    private void AddCustomXmlPartToWorkbook()
    {
        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 = this.CustomXMLParts.Add(xmlString, missing);
    }
    
  2. Dodaj AddCustomXmlPartToWorkbook metoda ThisWorkbook klasy w projekcie poziomie dokumentu dla programu Excel.

  3. Wywołaj metodę z innego kodu do projektu.Na przykład, aby utworzyć niestandardowa część kodu XML, gdy użytkownik otworzy skoroszyt, należy wywołać metodę z ThisWorkbook_Startup programu obsługi zdarzeń.

Aby dodać niestandardowe części XML do dokumentu programu Word

  1. Dodaj nowy CustomXMLPart obiekt do CustomXMLParts kolekcji w dokumencie.CustomXMLPart Zawiera ciąg XML, które mają być przechowywane w dokumencie.

    Private Sub AddCustomXmlPartToDocument()
        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 = _
            Me.CustomXMLParts.Add(xmlString)
    End Sub
    
    private void AddCustomXmlPartToDocument()
    {
        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 = this.CustomXMLParts.Add(xmlString, missing);
    }
    
  2. Dodaj AddCustomXmlPartToDocument metoda ThisDocument klasy w projekcie poziomie dokumentu dla programu Word.

  3. Wywołaj metodę z innego kodu do projektu.Na przykład, aby utworzyć niestandardowa część kodu XML, gdy użytkownik otwiera dokument, należy wywołać metodę z ThisDocument_Startup programu obsługi zdarzeń.

Stabilne programowanie

Dla uproszczenia w tym przykładzie użyto ciągu XML, który jest zdefiniowany jako zmiennej lokalnej w metodzie.Zazwyczaj należy uzyskać XML ze źródła zewnętrznego, na przykład pliku lub bazie danych.

Zobacz też

Zadania

Jak: dodawanie części XML niestandardowe do dokumentów przy użyciu dodatków poziomie aplikacji

Koncepcje

Przegląd części XML niestandardowych