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

Articolo
08/11/2011

È possibile archiviare dati XML nei tipi seguenti di documenti creando una web part XML personalizzata in un componente aggiuntivo a livello di applicazione:

Cartella di lavoro di Microsoft Office Excel.
Documento di Microsoft Office Word.
Presentazione di Microsoft Office PowerPoint.

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 applicazione per Excel 2007, Excel 2010, PowerPoint 2007, PowerPoint 2010, Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

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

Aggiungere un nuovo oggetto CustomXMLPart all'insieme CustomXMLParts della cartella di lavoro. L'oggetto CustomXMLPart contiene la stringa XML che si desidera memorizzare nella cartella di lavoro.

Nell'esempio di codice seguente una web part XML personalizzata viene aggiunta a una cartella di lavoro specificata.

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

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

Aggiungere il metodo AddCustomXmlPartToWorkbook alla classe ThisAddIn in un progetto a livello di applicazione per Excel.
Chiamare il metodo da altro codice nel progetto. Ad esempio, per creare la web part XML personalizzata quando l'utente apre una cartella di lavoro, chiamare il metodo da un gestore eventi per l'evento WorkbookOpen.

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

Aggiungere un nuovo oggetto CustomXMLPart all'insieme CustomXMLParts del documento. L'oggetto CustomXMLPart contiene la stringa XML che si desidera memorizzare nel documento.

Nell'esempio di codice seguente una web part XML personalizzata viene aggiunta a un documento specificato.

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

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

Aggiungere il metodo AddCustomXmlPartToDocument alla classe ThisAddIn in un progetto a livello di applicazione per Word.
Chiamare il metodo da altro codice nel progetto. Ad esempio, per creare la web part XML personalizzata quando l'utente apre un documento, chiamare il metodo da un gestore eventi per l'evento DocumentOpen.

Per aggiungere una web part XML personalizzata a una presentazione di PowerPoint

Aggiungere un nuovo oggetto CustomXMLPart all'insieme CustomXMLParts della presentazione. L'oggetto CustomXMLPart contiene la stringa XML che si desidera memorizzare nella presentazione.

Nell'esempio di codice seguente una web part XML personalizzata viene aggiunta a una presentazione specificata.

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

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

Aggiungere il metodo AddCustomXmlPartToPresentation alla classe ThisAddIn in un progetto a livello di applicazione per PowerPoint.
Chiamare il metodo da altro codice nel progetto. Ad esempio, per creare la web part XML personalizzata quando l'utente apre una presentazione, chiamare il metodo da un gestore eventi per l'evento AfterPresentationOpen.

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 personalizzazioni a livello di documento

Procedura: aggiungere web part XML personalizzate a documenti senza avviare Microsoft Office

Concetti

Cenni preliminari sulle web part XML personalizzate

Condividi tramite