Procedura: leggere e scrivere nelle proprietà dei documenti

Articolo
08/11/2011

È possibile memorizzare le proprietà del documento insieme a un documento nelle applicazioni di Microsoft Office elencate in precedenza. Queste applicazioni forniscono numerose proprietà incorporate, quali l'autore, il titolo e l'oggetto. In questo argomento viene illustrato come impostare le proprietà del documento in Microsoft Office Excel e Microsoft Office Word.

Collegamento a video Per una dimostrazione video correlata, vedere How Do I: Access and Manipulate Custom Document Properties in Microsoft Word? (la pagina potrebbe essere in inglese).

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Excel 2007, Excel 2010, PowerPoint 2007, PowerPoint 2010, Project 2007, Project 2010, Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Impostazione delle proprietà del documento in Excel

Per utilizzare le proprietà incorporate in Excel, utilizzare le seguenti proprietà:

In un progetto a livello di documento utilizzare la proprietà BuiltinDocumentProperties della classe ThisWorkbook.
In un progetto a livello di applicazione utilizzare la proprietà BuiltinDocumentProperties di un oggetto Microsoft.Office.Interop.Excel.Workbook.

Queste proprietà restituiscono un oggetto DocumentProperties, che rappresenta un insieme di oggetti DocumentProperty. È possibile utilizzare la proprietà Item dell'insieme per recuperare una determinata proprietà in base al nome o all'indice a esso associato nell'insieme.

Nell'esempio di codice riportato di seguito viene illustrato come modificare la proprietà Revision Number incorporata in un progetto a livello di documento.

Per modificare la proprietà Revision Number in Excel

Assegnare le proprietà incorporate del documento a una variabile.

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"];

Incrementare di uno la proprietà Revision Number.

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

Impostazione delle proprietà del documento in Word

Per utilizzare le proprietà incorporate in Word, utilizzare le proprietà seguenti:

In un progetto a livello di documento utilizzare la proprietà BuiltInDocumentProperties della classe ThisDocument.
In un progetto a livello di applicazione utilizzare la proprietà BuiltInDocumentProperties di un oggetto Microsoft.Office.Interop.Word.Document.

Nell'esempio di codice riportato di seguito viene illustrato come modificare la proprietà Subject incorporata in un progetto a livello di documento.

Per modificare la proprietà Subject

Assegnare le proprietà incorporate del documento a una variabile.

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;

Modificare la proprietà Subject in "Whitepaper".

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

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

Programmazione efficiente

Gli esempi presuppongono che il codice sia stato scritto nella classe ThisWorkbook in un progetto a livello di documento per Excel e nella classe ThisDocument in un progetto a livello di documento per Word.

Anche se si utilizzano Word ed Excel e i relativi oggetti, Microsoft Office fornisce l'elenco delle proprietà incorporate disponibili per i documenti. Se si tenta di accedere a una proprietà non definita, viene generata un'eccezione.