Čtení z vlastností dokumentu a zápis do dokumentu

  • Článek

Vlastnosti dokumentu můžete uložit spolu s dokumentem. aplikace Office lications poskytují řadu předdefinovaných vlastností, jako je autor, název a předmět. Toto téma ukazuje, jak nastavit vlastnosti dokumentu v aplikaci systém Microsoft Office Excel a systém Microsoft Office Word.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentů a projekty doplňků VSTO pro následující aplikace: Excel; Powerpoint; Projektu; Slovo. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Nastavení vlastností dokumentu v Excelu

Pokud chcete pracovat s integrovanými vlastnostmi v Excelu, použijte následující vlastnosti:

  • V projektu na úrovni dokumentu použijte BuiltinDocumentProperties vlastnost ThisWorkbook třídy.

  • V projektu doplňku VSTO použijte BuiltinDocumentProperties vlastnost objektu Workbook .

    Tyto vlastnosti vrací DocumentProperties objekt, což je kolekce DocumentProperty objektů. Vlastnost kolekce můžete použít Item k načtení konkrétní vlastnosti, a to buď podle názvu, nebo indexu v kolekci.

    Následující příklad kódu ukazuje, jak změnit předdefinované číslo revize vlastnost v projektu na úrovni dokumentu.

Změna vlastnosti Číslo revize v Excelu

  1. Přiřaďte předdefinované vlastnosti dokumentu proměnné.

    Microsoft.Office.Core.DocumentProperties properties;

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

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

  2. Zvýší Revision Number vlastnost o jednu.

    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í vlastností dokumentu ve Wordu

Pokud chcete pracovat s integrovanými vlastnostmi ve Wordu, použijte následující vlastnosti:

  • V projektu na úrovni dokumentu použijte BuiltInDocumentProperties vlastnost ThisDocument třídy.

  • V projektu doplňku VSTO použijte BuiltInDocumentProperties vlastnost objektu Document .

    Tyto vlastnosti vrací DocumentProperties objekt, což je kolekce DocumentProperty objektů. Vlastnost kolekce můžete použít Item k načtení konkrétní vlastnosti, a to buď podle názvu, nebo indexu v kolekci.

    Následující příklad kódu ukazuje, jak změnit integrovanou vlastnost Předmět v projektu na úrovni dokumentu.

Změna vlastnosti Předmět

  1. Přiřaďte předdefinované vlastnosti dokumentu proměnné.

    Microsoft.Office.Core.DocumentProperties properties;

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

  2. Subject Změňte vlastnost na White paper.

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

Robustní programování

Příklady předpokládají, že jste kód napsali ve ThisWorkbook třídě v projektu na úrovni dokumentu pro Excel a ThisDocument třídu v projektu na úrovni dokumentu pro Word.

I když pracujete s Wordem a Excelem a jejich objekty, systém Microsoft Office poskytuje seznam dostupných předdefinovaných vlastností dokumentu. Pokus o přístup k nedefinované vlastnosti vyvolá výjimku.

Související obsah