Freigeben über

Lesen und Schreiben in Dokumenteigenschaften

  • Artikel

Sie können Dokumenteigenschaften zusammen mit einem Dokument speichern. Office-Anwendungen stellen eine Reihe integrierter Eigenschaften (z. B. Autor, Titel und Betreff) bereit. In diesem Thema wird gezeigt, wie Dokumenteigenschaften in Microsoft Office Excel und Microsoft Office Word festgelegt werden.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für die folgenden Anwendungen: Excel; Powerpoint; Projekt; Wort. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

Festlegen von Dokumenteigenschaften in Excel

Verwenden Sie die folgenden Eigenschaften, um in Excel mit integrierten Eigenschaften zu arbeiten:

  • In einem Projekt auf Dokumentebene verwenden Sie die Eigenschaft BuiltinDocumentProperties der Klasse ThisWorkbook .

  • Verwenden Sie in einem VSTO-Add-In-Projekt die Eigenschaft BuiltinDocumentProperties eines Workbook -Objekts.

    Diese Eigenschaften geben eine DocumentProperties -Objekt zurück, das eine Auflistung von DocumentProperty -Objekten ist. Sie können die Eigenschaft Item der Auflistung verwenden, um eine bestimmte Eigenschaft nach Name oder Index in der Auflistung abzurufen.

    Im folgenden Codebeispiel wird veranschaulicht, wie die integrierte Eigenschaft Revision Number in einem Projekt auf Dokumentebene geändert wird.

So ändern Sie die Eigenschaft "Revisionsnummer" in Excel

  1. Weisen Sie die integrierten Eigenschaften einer Variablen zu.

    Microsoft.Office.Core.DocumentProperties properties;

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

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

  2. Inkrementieren Sie die Eigenschaft Revision Number um eins.

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

Festlegen von Dokumenteigenschaften in Word

Verwenden Sie die folgenden Eigenschaften, um in Word mit integrierten Eigenschaften zu arbeiten:

  • In einem Projekt auf Dokumentebene verwenden Sie die Eigenschaft BuiltInDocumentProperties der Klasse ThisDocument .

  • Verwenden Sie in einem VSTO-Add-In-Projekt die Eigenschaft BuiltInDocumentProperties eines Document -Objekts.

    Diese Eigenschaften geben eine DocumentProperties -Objekt zurück, das eine Auflistung von DocumentProperty -Objekten ist. Sie können die Eigenschaft Item der Auflistung verwenden, um eine bestimmte Eigenschaft nach Name oder Index in der Auflistung abzurufen.

    Im folgenden Codebeispiel wird veranschaulicht, wie die integrierte Eigenschaft Subject in einem Projekt auf Dokumentebene geändert wird.

So ändern Sie die Eigenschaft "Subject"

  1. Weisen Sie die integrierten Eigenschaften einer Variablen zu.

    Microsoft.Office.Core.DocumentProperties properties;

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

  2. Ändern Sie die Eigenschaft Subject in "Whitepaper".

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

Stabile Programmierung

In den Beispielen wird davon ausgegangen, dass Sie den Code in der Klasse ThisWorkbook in einem Projekt auf Dokumentebene für Excel und in der Klasse ThisDocument in einem Projekt auf Dokumentebene für Word geschrieben haben.

Auch wenn Sie mit Word und Excel und deren Objekten arbeiten, stellt Microsoft Office die Liste der verfügbaren integrierten Dokumenteigenschaften zur Verfügung. Wenn versucht wird, auf eine nicht definierte Eigenschaft zuzugreifen, wird eine Ausnahme ausgelöst.

Zugehöriger Inhalt