Condividi tramite

Aggiungere parti XML personalizzate alle personalizzazioni a livello di documento

  • Articolo

È possibile archiviare dati XML in una cartella di lavoro di Microsoft Office Excel o in un documento di Microsoft Office Word creando una parte XML personalizzata in una personalizzazione a livello di documento. Per altre informazioni, vedere Panoramica delle parti XML personalizzate.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento per Excel e Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Nota

Visual Studio non offre progetti a livello di documento per Microsoft Office PowerPoint. Per informazioni sull'aggiunta di una parte XML personalizzata a una presentazione di PowerPoint tramite un componente aggiuntivo VSTO, vedere Procedura: Aggiungere parti XML personalizzate ai documenti tramite componenti aggiuntivi VSTO.

Per aggiungere una parte 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 vuole memorizzare nella cartella di lavoro.

    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);
}

  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 parte XML personalizzata quando l'utente apre la cartella di lavoro, chiamare il metodo dal gestore eventi ThisWorkbook_Startup .

Per aggiungere una parte 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 vuole memorizzare nel documento.

    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);
}

  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. Per creare, ad esempio, la parte XML personalizzata quando l'utente apre il documento, chiamare il metodo dal gestore eventi ThisDocument_Startup .

Programmazione efficiente

Per semplicità, in questo esempio viene usata 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.

Contenuto correlato