Condividi tramite


Procedura: aggiungere web part XML personalizzate a personalizzazioni a livello di documento

È possibile archiviare dati XML in una cartella di lavoro di Microsoft Office Excel o un documento di Microsoft Office Word creando una web part XML personalizzata in una personalizzazione a livello di documento.Per ulteriori informazioni, vedere Cenni preliminari sulle web part XML personalizzate.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2013, Excel 2010, Word 2013 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

[!NOTA]

In Visual Studio non vengono forniti progetti a livello di documento per Microsoft Office PowerPoint.Per informazioni sull'aggiunta di una web part XML personalizzata a una presentazione di PowerPoint utilizzando un componente aggiuntivo a livello di applicazione, vedere Procedura: aggiungere web part XML personalizzate a documenti utilizzando componenti aggiuntivi a livello di applicazione.

Per aggiungere una web part XML personalizzata a una cartella di lavoro di Excel

  1. Aggiungere un nuovo oggetto CustomXMLPart alla raccolta CustomXMLParts della cartella di lavoro.CustomXMLPart contiene la stringa XML che si desidera memorizzare nella cartella di lavoro.

    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. Aggiungere il metodo AddCustomXmlPartToWorkbook alla classe ThisWorkbook in un progetto a livello di documento per Excel.

  3. Chiamare il metodo da altro codice nel progetto.Ad esempio, per creare la web part XML personalizzata quando l'utente apre la cartella di lavoro, chiamare il metodo dal gestore eventi ThisWorkbook_Startup.

Per aggiungere una web part XML personalizzata a un documento di Word

  1. Aggiungere un nuovo oggetto CustomXMLPart alla raccolta CustomXMLParts del documento.CustomXMLPart contiene la stringa XML che si desidera memorizzare nel documento.

    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. Aggiungere il metodo AddCustomXmlPartToDocument alla classe ThisDocument in un progetto a livello di documento per Word.

  3. Chiamare il metodo da altro codice nel progetto.Ad esempio, per creare la web part XML personalizzata quando l'utente apre il documento, chiamare il metodo dal gestore eventi ThisDocument_Startup.

Programmazione efficiente

Per semplicità, in questo esempio viene utilizzata una stringa XML definita come variabile locale nel metodo.In genere, è necessario ottenere l'XML da un'origine esterna, ad esempio un file o un database.

Vedere anche

Attività

Procedura: aggiungere web part XML personalizzate a documenti utilizzando componenti aggiuntivi a livello di applicazione

Concetti

Cenni preliminari sulle web part XML personalizzate