Postupy: Čtení z vlastností dokumentu a zápis do nich

Článek
05/16/2015

Můžete uložit vlastnosti dokumentu s dokumentem.Aplikace sady Office poskytují určitý počet předdefinovaných vlastností, například autor, název a předmět.Toto téma ukazuje, jak nastavit vlastnosti dokumentu v aplikaci Microsoft Office Excel a Microsoft Office Word.

odkaz na video Související video ukázku naleznete v tématu Jak provést I: přístup a manipulaci s vlastnosti vlastního dokumentu v aplikaci Microsoft Word?.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v těchto aplikacích: Excel 2013 a Excel 2010, PowerPoint 2013 a PowerPoint 2010, Project 2013 a Project 2010; Word 2013 a Word 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Nastavení vlastností dokumentů v aplikaci Excel

Práce s předdefinované vlastnosti v aplikaci Excel, použijte následující vlastnosti:

V úrovni dokumentů projektu použít BuiltinDocumentProperties vlastnost ThisWorkbook třídy.
V projektu úrovni aplikace použít BuiltinDocumentProperties vlastnost Workbook objektu.

Tyto vlastnosti vracejí DocumentProperties objekt, který je kolekce z DocumentProperty objekty.Můžete použít Item vlastnost v kolekci načíst konkrétní vlastnost název nebo index v rámci kolekce.

Následující příklad kódu ukazuje, jak změnit vestavěnou Revision Number vlastnost v úrovni dokumentů projektu.

Chcete-li změnit vlastnost číslo revize v aplikaci Excel

Vlastnosti dokumentu vestavěné přiřadíte proměnné.

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

Přírůstek Revision Number o jednu vlastnost.

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

Nastavení vlastnosti dokumentu v aplikaci Word

Práce s předdefinované vlastnosti v aplikaci Word, použijte následující vlastnosti:

V úrovni dokumentů projektu použít BuiltInDocumentProperties vlastnost ThisDocument třídy.
V projektu úrovni aplikace použít BuiltInDocumentProperties vlastnost Document objektu.

Následující příklad kódu ukazuje, jak změnit vestavěnou Subject vlastnost v úrovni dokumentů projektu.

Chcete-li změnit vlastnost předmětu

Vlastnosti dokumentu vestavěné přiřadíte proměnné.

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;

Změnit Subject vlastnost "Dokument White Paper".

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

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

Robustní programování

V příkladech se předpokládá, že jste napsali kód ThisWorkbook třídy v projektu úrovni dokumentu v aplikaci Excel a ThisDocument třídy v projektu úrovni dokumentu aplikace Word.

I když pracujete s aplikací Word a Excel a jejich objekty, Microsoft Office poskytuje seznam dokumentu k dispozici předdefinované vlastnosti.Při pokusu o přístup k nedefinované vlastnosti vyvolá výjimku.