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

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 documento Versione Microsoft Office Excel 2007 Word 2007 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

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

Nota:

Visual Studio Tools per Office non fornisce 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 Microsoft.Office.Core.CustomXMLPart all'insieme Microsoft.Office.Core.CustomXMLParts della cartella di lavoro. Microsoft.Office.Core.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 2007.

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 Microsoft.Office.Core.CustomXMLPart all'insieme Microsoft.Office.Core.CustomXMLParts del documento. Microsoft.Office.Core.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 2007.

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

Procedura: aggiungere parti XML personalizzate a documenti senza avviare Microsoft Office

Concetti

Cenni preliminari sulle web part XML personalizzate