Comment : lire des propriétés de document et en écrire

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Version de Microsoft Office Version 2007 de Microsoft Office System Microsoft Office 2003 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous pouvez stocker des propriétés du document avec le document ou le classeur dans des personnalisations au niveau du document pour Microsoft Office Word et Microsoft Office Excel. Excel et Word fournissent plusieurs propriétés intégrées telles que Author, Title et Subject.

Définition des propriétés de document dans Excel

Utilisez la propriété BuiltinDocumentProperties de la classe ThisWorkbook pour utiliser des propriétés intégrées. Cette propriété retourne un objet DocumentProperties qui est une collection d'objets DocumentProperty. Vous pouvez utiliser la propriété Item de la collection pour récupérer une propriété particulière, par nom ou par index dans la collection.

Pour modifier la propriété Revision Number dans Excel

1. Assignez les propriétés de document intégrées à une variable.

   Dim properties As Microsoft.Office.Core.DocumentProperties
   
   properties = DirectCast(Globals.ThisWorkbook.BuiltinDocumentProperties, _
       Microsoft.Office.Core.DocumentProperties)
   
   Dim prop As Microsoft.Office.Core.DocumentProperty
   prop = properties.Item("Revision Number")
   

   Microsoft.Office.Core.DocumentProperties properties;
   
   properties = (Microsoft.Office.Core.DocumentProperties)
       Globals.ThisWorkbook.BuiltinDocumentProperties; 
   
   Microsoft.Office.Core.DocumentProperty prop;
   prop = properties["Revision Number"]; 
   

2. Incrémentez la propriété Revision Number de un.

   If prop.Value Is Nothing Then
       prop.Value = 1
   Else
       Dim revision As Integer
       If Integer.TryParse(prop.Value.ToString(), revision) Then
           prop.Value = revision + 1
           MessageBox.Show("Revision Number = " & revision)
       Else
           MessageBox.Show("Revision Number = invalid value")
       End If
   End If
   

   if (prop.Value == null)
   {
       prop.Value = 1;
   }
   else
   {
       int revision;
       if (int.TryParse((string)prop.Value, out revision))
       {
           prop.Value = revision + 1;
           MessageBox.Show("Revision Number = " + revision);
       }
       else
       {
           MessageBox.Show("Revision Number = invalid value");
       }
   }
   

Définition des propriétés de document dans Word

Utilisez la propriété BuiltInDocumentProperties de la classe ThisDocument pour utiliser des propriétés intégrées. Cette propriété retourne un objet DocumentProperties qui est une collection d'objets DocumentProperty. Vous pouvez utiliser la propriété Item de la collection pour récupérer une propriété particulière, par nom ou par index dans la collection.

Pour modifier la propriété Subject

1. Assignez les propriétés de document intégrées à une variable.

   Dim properties As Microsoft.Office.Core.DocumentProperties
   
   properties = DirectCast(Globals.ThisDocument.BuiltInDocumentProperties, _
       Microsoft.Office.Core.DocumentProperties)
   

   Microsoft.Office.Core.DocumentProperties properties;
   
   properties = (Microsoft.Office.Core.DocumentProperties)
       Globals.ThisDocument.BuiltInDocumentProperties; 
   

2. Remplacez la valeur de la propriété Subject par « Whitepaper ».

   ' Set the Subject property.
   properties.Item("Subject").Value = "Whitepaper"
   

   // Set the Subject property. 
   properties["Subject"].Value = "Whitepaper"; 
   

Programmation fiable

Les exemples supposent que vous avez écrit du code dans la classe ThisWorkbook pour Excel et la classe ThisDocument pour Word.

Bien que vous utilisiez Word et Excel ainsi que leurs objets, Microsoft Office fournit la liste des propriétés de document intégrées disponibles. La tentative d'accès à la propriété Value pour les propriétés non définies lève une exception.

Voir aussi

Tâches

Comment : créer et modifier des propriétés de document personnalisées

Concepts

Programmation de personnalisations au niveau du document