Condividi tramite


Leggere e scrivere nelle proprietà del documento

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