Share via

Leggere e scrivere nelle proprietà del documento

  • Articolo

È possibile archiviare le proprietà del documento insieme a un documento. Le applicazioni di Office offrono svariate proprietà predefinite, ad esempio autore, titolo e oggetto. Questo argomento illustra come impostare le proprietà dei documenti in Microsoft Office Excel e Microsoft Office Word.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per le applicazioni seguenti: Excel; Powerpoint; Progetto; Parola. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Impostare le proprietà del documento in Excel

Per usare le proprietà predefinite in Excel, configurare le proprietà seguenti:

  • In un progetto a livello di documento usare la proprietà BuiltinDocumentProperties della classe ThisWorkbook .

  • In un progetto a livello di componente aggiuntivo VSTO, usare la proprietà BuiltinDocumentProperties di un oggetto Workbook .

    Queste proprietà restituiscono un oggetto DocumentProperties , che rappresenta una raccolta di oggetti DocumentProperty . È possibile usare la proprietà Item della raccolta per recuperare una proprietà specifica, in base al nome o in base all'indice nella raccolta.

    L'esempio di codice seguente illustra come modificare la proprietà predefinita Revision Number in un progetto a livello di documento.

Per modificare la proprietà Numero revisione in Excel

  1. Assegnare le proprietà predefinite del documento a una variabile.

    Microsoft.Office.Core.DocumentProperties properties;

properties = (Microsoft.Office.Core.DocumentProperties)
    Globals.ThisWorkbook.BuiltinDocumentProperties; 

Microsoft.Office.Core.DocumentProperty prop;
prop = properties["Revision Number"];

  2. Incrementare di uno la proprietà Revision Number .

    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");
    }
}

Impostare le proprietà del documento in Word

Per usare le proprietà predefinite in Word, configurare le proprietà seguenti:

  • In un progetto a livello di documento usare la proprietà BuiltInDocumentProperties della classe ThisDocument .

  • In un progetto a livello di componente aggiuntivo VSTO, usare la proprietà BuiltInDocumentProperties di un oggetto Document .

    Queste proprietà restituiscono un oggetto DocumentProperties , che rappresenta una raccolta di oggetti DocumentProperty . È possibile usare la proprietà Item della raccolta per recuperare una proprietà specifica, in base al nome o in base all'indice nella raccolta.

    L'esempio di codice seguente illustra come modificare la proprietà predefinita Subject in un progetto a livello di documento.

Per modificare la proprietà Oggetto

  1. Assegnare le proprietà predefinite del documento a una variabile.

    Microsoft.Office.Core.DocumentProperties properties;

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

  2. Modificare la proprietà Subject in "White paper".

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

Programmazione efficiente

Questo esempio presuppone che il codice della classe ThisWorkbook sia stato scritto in un progetto a livello di documento per Excel e quello della classe ThisDocument in un progetto a livello di documento per Word.

Anche se si usano Word ed Excel e i rispettivi oggetti, Microsoft Office fornisce l'elenco di proprietà predefinite disponibili per i documenti. Il tentativo di accesso a una proprietà non definita provocherà un'eccezione.

Contenuto correlato