Comment : ajouter des parties XML personnalisées aux personnalisations au niveau du document

Mise à jour : novembre 2007

Pour stocker les données XML dans un classeur Microsoft Office Excel ou dans un document Microsoft Office Word, créez une partie XML personnalisée dans une personnalisation au niveau du document. Pour plus d'informations, consultez Vue d'ensemble des parties XML personnalisées.

Remarque :
Visual Studio Tools pour Office ne fournit pas de projets au niveau du document pour Microsoft Office PowerPoint. Pour plus d'informations sur l'ajout d'une partie XML personnalisée à une présentation PowerPoint à l'aide d'un complément au niveau de l'application, consultez Comment : ajouter des parties XML personnalisées à des documents à l'aide de compléments d'application.

Pour ajouter une partie XML personnalisée à un classeur Excel

1. Ajoutez un nouvel objet Microsoft.Office.Core.CustomXMLPart à la collection Microsoft.Office.Core.CustomXMLParts du classeur. Microsoft.Office.Core.CustomXMLPart contient la chaîne XML à stocker dans le classeur.

   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. Ajoutez la méthode AddCustomXmlPartToWorkbook à la classe ThisWorkbook dans un projet au niveau du document pour Excel 2007.

3. Appelez la méthode à partir d'un autre code dans votre projet. Par exemple, pour créer la partie XML personnalisée lorsque l'utilisateur ouvre le classeur, appelez la méthode à partir du gestionnaire d'événements ThisWorkbook_Startup.

Pour ajouter une partie XML personnalisée à un document Word

1. Ajoutez un nouvel objet Microsoft.Office.Core.CustomXMLPart à la collection Microsoft.Office.Core.CustomXMLParts du document. Microsoft.Office.Core.CustomXMLPart contient la chaîne XML à stocker dans le document.

   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. Ajoutez la méthode AddCustomXmlPartToDocument à la classe ThisDocument dans un projet au niveau du document pour Word 2007.

3. Appelez la méthode à partir d'un autre code dans votre projet. Par exemple, pour créer la partie XML personnalisée lorsque l'utilisateur ouvre le document, appelez la méthode à partir du gestionnaire d'événements ThisDocument_Startup.

Programmation fiable

Pour simplifier, cet exemple utilise une chaîne XML définie comme variable locale dans la méthode. En général, vous devez obtenir le code XML auprès d'une source externe, comme un fichier ou une base de données.

Voir aussi

Tâches

Comment : ajouter des parties XML personnalisées à des documents à l'aide de compléments d'application

Comment : ajouter des parties XML personnalisées à des documents sans démarrer Microsoft Office

Concepts

Vue d'ensemble des parties XML personnalisées