Procedura: leggere e scrivere nelle proprietà dei documenti
È 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.
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.
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à 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.
Vedere anche
Attività
Procedura: creare e modificare proprietà personalizzate di un documento
Altre risorse
Programmazione di componenti aggiuntivi a livello di applicazione
Programmazione delle personalizzazioni a livello di documento