Udostępnij za pośrednictwem

Odczytywanie i zapisywanie we właściwościach dokumentu

  • Artykuł

Właściwości dokumentu można przechowywać wraz z dokumentem. aplikacja pakietu Office lications zapewniają szereg wbudowanych właściwości, takich jak autor, tytuł i temat. W tym temacie pokazano, jak ustawić właściwości dokumentu w programie Microsoft Office Excel i programie Microsoft Office Word.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla następujących aplikacji: Excel; Powerpoint; Projektu; Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Ustawianie właściwości dokumentu w programie Excel

Aby pracować z wbudowanymi właściwościami w programie Excel, użyj następujących właściwości:

  • W projekcie na poziomie dokumentu użyj BuiltinDocumentProperties właściwości ThisWorkbook klasy .

  • W projekcie dodatku VSTO użyj BuiltinDocumentProperties właściwości Workbook obiektu.

    Te właściwości zwracają DocumentProperties obiekt, który jest kolekcją DocumentProperty obiektów. Możesz użyć Item właściwości kolekcji, aby pobrać określoną właściwość według nazwy lub indeksu w kolekcji.

    Poniższy przykład kodu pokazuje, jak zmienić wbudowaną właściwość Numer poprawki w projekcie na poziomie dokumentu.

Aby zmienić właściwość Numer poprawki w programie Excel

  1. Przypisz wbudowane właściwości dokumentu do zmiennej.

    Microsoft.Office.Core.DocumentProperties properties;

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

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

  2. Zwiększ Revision Number właściwość o jeden.

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

Ustawianie właściwości dokumentu w programie Word

Aby pracować z wbudowanymi właściwościami w programie Word, użyj następujących właściwości:

  • W projekcie na poziomie dokumentu użyj BuiltInDocumentProperties właściwości ThisDocument klasy .

  • W projekcie dodatku VSTO użyj BuiltInDocumentProperties właściwości Document obiektu.

    Te właściwości zwracają DocumentProperties obiekt, który jest kolekcją DocumentProperty obiektów. Możesz użyć Item właściwości kolekcji, aby pobrać określoną właściwość według nazwy lub indeksu w kolekcji.

    Poniższy przykład kodu pokazuje, jak zmienić wbudowaną właściwość Subject w projekcie na poziomie dokumentu.

Aby zmienić właściwość Subject

  1. Przypisz wbudowane właściwości dokumentu do zmiennej.

    Microsoft.Office.Core.DocumentProperties properties;

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

  2. Zmień właściwość na Subject "Oficjalny dokument".

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

Niezawodne programowanie

W przykładach założono, że kod został napisany w klasie w ThisWorkbook projekcie na poziomie dokumentu dla programu Excel oraz ThisDocument klasą w projekcie na poziomie dokumentu dla programu Word.

Mimo że pracujesz z programami Word i Excel i ich obiektami, pakiet Microsoft Office udostępnia listę dostępnych wbudowanych właściwości dokumentu. Próba uzyskania dostępu do niezdefiniowanej właściwości zgłasza wyjątek.

Powiązana zawartość