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

Articolo
04/28/2010

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di applicazione Versione Microsoft Office Excel 2007 PowerPoint 2007 Word 2007 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di applicazione

Versione Microsoft Office

Excel 2007
PowerPoint 2007
Word 2007

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

È 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.

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

Aggiungere un nuovo oggetto Microsoft.Office.Core.CustomXMLPart all'insieme Microsoft.Office.Core.CustomXMLParts della cartella di lavoro. L'oggetto Microsoft.Office.Core.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 2007.
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 Microsoft.Office.Interop.Excel.Application.WorkbookOpen.

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

Aggiungere un nuovo oggetto Microsoft.Office.Core.CustomXMLPart all'insieme Microsoft.Office.Core.CustomXMLParts del documento. L'oggetto Microsoft.Office.Core.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 2007.
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 Microsoft.Office.Interop.Word.Application.DocumentOpen.

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

Aggiungere un nuovo oggetto Microsoft.Office.Core.CustomXMLPart all'insieme Microsoft.Office.Core.CustomXMLParts della presentazione. L'oggetto Microsoft.Office.Core.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 2007.
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 Microsoft.Office.Interop.PowerPoint.Application.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 parti XML personalizzate a documenti senza avviare Microsoft Office

Concetti

Cenni preliminari sulle web part XML personalizzate

Condividi tramite