Gewusst wie: Lesen von und Schreiben in Dokumenteigenschaften

Artikel
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Dokumentebene Microsoft Office-Version 2007 Microsoft Office System Microsoft Office 2003 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

Projekte auf Dokumentebene

Microsoft Office-Version

2007 Microsoft Office System
Microsoft Office 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Sie können Dokumenteigenschaften zusammen mit dem Dokument oder der Arbeitsmappe in Anpassungen auf Dokumentebene für Microsoft Office Word oder Microsoft Office Excel speichern. Excel und Word stellen eine Reihe integrierter Eigenschaften wie Autor, Titel und Betreff zur Verfügung.

Festlegen von Dokumenteigenschaften in Excel

Verwenden Sie die BuiltinDocumentProperties-Eigenschaft der ThisWorkbook-Klasse, um mit integrierten Eigenschaften zu arbeiten. Diese Eigenschaft gibt 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.

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 BuiltInDocumentProperties-Eigenschaft der ThisDocument-Klasse, um mit integrierten Eigenschaften zu arbeiten. Diese Eigenschaft gibt 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.

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 diesem Beispiel wird davon ausgegangen, dass Sie den Code in der ThisWorkbook-Klasse für Excel und in der ThisDocument-Klasse für Word 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. Beim Versuch, auf die Value-Eigenschaft für nicht definierte Eigenschaften zuzugreifen, wird eine Ausnahme ausgelöst.

Siehe auch

Aufgaben

Gewusst wie: Erstellen und Ändern von benutzerdefinierten Dokumenteigenschaften

Konzepte

Programmieren von Anpassungen auf Dokumentebene

Freigeben über