Share via

Lire et écrire dans les propriétés du document

  • Article

Vous pouvez stocker des propriétés de document avec un document. Les applications Office fournissent plusieurs propriétés intégrées, telles que l'auteur, le titre et l'objet. Cette rubrique indique comment définir des propriétés de document dans Microsoft Office Excel et Microsoft Office Word.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document et aux projets de complément VSTO pour les applications suivantes : Excel ; Powerpoint; Projet; Mot. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

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

Pour travailler avec des propriétés intégrées dans Excel, utilisez les propriétés suivantes :

  • Dans un projet au niveau du document, utilisez la propriété BuiltinDocumentProperties de la classe ThisWorkbook .

  • Dans un projet de complément VSTO, utilisez la propriété BuiltinDocumentProperties d'un objet Workbook .

    Ces propriétés retournent 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.

    L'exemple de code suivant indique comment modifier la propriété intégrée Revision Number dans un projet au niveau du document.

Pour modifier la propriété Revision Number dans Excel

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

    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 == 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éfinir les propriétés du document dans Word

Pour travailler avec des propriétés intégrées dans Word, utilisez les propriétés suivantes :

  • Dans un projet au niveau du document, utilisez la propriété BuiltInDocumentProperties de la classe ThisDocument .

  • Dans un projet de complément VSTO, utilisez la propriété BuiltInDocumentProperties d'un objet Document .

    Ces propriétés retournent 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.

    L'exemple de code suivant indique comment modifier la propriété intégrée Subject dans un projet au niveau du document.

Pour modifier la propriété Subject

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

    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["Subject"].Value = "Whitepaper";

Programmation fiable

Les exemples supposent que vous avez écrit le code dans la classe ThisWorkbook dans un projet au niveau du document pour Excel et dans la classe ThisDocument dans un projet au niveau du document 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. Toute tentative d'accès à une propriété non définie lève une exception.

Contenu connexe