Gewusst wie: Lesen von und Schreiben in Dokumenteigenschaften

Artikel
02/26/2013

Sie können Dokumenteigenschaften zusammen mit einem Dokument speichern.Office-Anwendungen bieten mehrere integrierte Eigenschaften, wie Autor, Name und Betreff.Dieses Thema zeigt, wie Dokumenteigenschaften in Microsoft Office Excel und Microsoft Office Word festgelegt werden.

Link zu Video Eine entsprechende Videodemo finden Sie unter How Do I: Access and Manipulate Custom Document Properties in Microsoft Word?.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument - und Anwendungsebene für die folgenden Anwendungen: Excel 2013 und Excel 2010, PowerPoint 2013 und PowerPoint 2010, Project 2013 und Project 2010, Word 2013 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Festlegen von Dokumenteigenschaften in Excel

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

In einem Projekt auf Dokumentebene für Word verwenden Sie die BuiltinDocumentProperties-Eigenschaft der ThisWorkbook-Klasse.
In einem Projekt auf Anwendungsebene verwenden Sie die BuiltinDocumentProperties-Eigenschaft eines Microsoft.Office.Interop.Excel.Workbook-Objekts.

Diese Eigenschaften geben ein DocumentProperties-Objekt zurück, das eine Auflistung der DocumentProperty-Objekte darstellt.Sie können die Item-Eigenschaft der Auflistung verwenden, um eine bestimmte Eigenschaft innerhalb der Auflistung anhand des Namens oder des Index abzurufen.

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

So ändern Sie die Revisionsnummer-Eigenschaft in Excel

Weisen Sie einer Variablen die integrierten Dokumenteigenschaften zu.

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

Erhöhen Sie die Revision Number-Eigenschaft um eins.

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

Festlegen von Dokumenteigenschaften in Word

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

In einem Projekt auf Dokumentebene für Word verwenden Sie die BuiltInDocumentProperties-Eigenschaft der ThisDocument-Klasse.
In einem Projekt auf Anwendungsebene verwenden Sie die BuiltInDocumentProperties-Eigenschaft eines Microsoft.Office.Interop.Word.Document-Objekts.

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

So ändern Sie die Betreff-Eigenschaft

Weisen Sie einer Variablen die integrierten Dokumenteigenschaften zu.

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;

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

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

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

Robuste Programmierung

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

Auch wenn Sie Word und Excel und die zugehörigen Objekte einsetzen, stellt Microsoft Office eine Liste der verfügbaren integrierten Dokumenteigenschaften zur Verfügung.Bei dem Versuch, auf eine nicht definierte Eigenschaft zuzugreifen, wird eine Ausnahme ausgelöst.