DocumentProperties.Add-Methode (Office)

  • Artikel

Erstellt ein neue benutzerdefinierte Dokumenteigenschaft. Sie können eine neue Dokumenteigenschaft nur zu der benutzerdefinierten DocumentProperties-Sammlung hinzufügen.

Syntax

expression.Add (Name, LinkToContent, Type, Value, LinkSource)

Ausdruck: Erforderlich. Eine Variable, die ein Document-Objekt darstellt. Das benutzerdefinierte DocumentProperties-Objekt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Name Erforderlich String Die Zeichenfolge derName-Eigenschaft.
LinkToContent Erforderlich Boolean Gibt an, ob die LinkToContent-Eigenschaft mit den Inhalten des Containerdokuments verknüpft ist. Wenn dieses Argument True ist, ist das LinkSource-Argument erforderlich; wenn es False ist, ist das Value-Argument erforderlich ist.
Type Optional Variant Der Datentyp der Type-Eigenschaft. Kann eine der folgenden MsoDocProperties-Konstanten sein: msoPropertyTypeBoolean, msoPropertyTypeDate, msoPropertyTypeFloat, msoPropertyTypeNumber oder msoPropertyTypeString.
Wert Optional Variant Den Datenwert der Value-Eigenschaft, wenn diese nicht mit den Inhalten des Containerdokuments verknüpft ist. Der Wert wird so konvertiert, dass er dem vom Type-Argument angegebenen Datentyp entspricht. Wenn der Wert nicht konvertiert werden kann, tritt ein Fehler auf. Wenn LinkToContent den Wert True aufweist, wird das Argument ignoriert, und der neuen Dokumenteigenschaft wird ein Standardwert zugewiesen, bis die verknüpften Eigenschaftswerte von der Containeranwendung aktualisiert werden (in der Regel, wenn das Dokument gespeichert wird).
LinkSource Optional Variant Ignoriert, wenn LinkToContentFalse ist. Die Quelle der LinkSource-Eigenschaft. Die Containeranwendung bestimmt, welche Arten von Quellverknüpfung verwendet werden können. DDE-Links verwenden beispielsweise die Syntax "Server|Document!Item".

HinwBemerkungeneise

Wenn Sie eine benutzerdefinierte Dokumenteigenschaft der DocumentProperties-Auflistung hinzufügen, die mit einem bestimmten Wert in einem Office-Dokument verknüpft ist, müssen Sie das Dokument speichern, um die Änderung an dem DocumentProperty-Objekt anzuzeigen.

Beispiel

In diesem Beispiel, das für die Ausführung in Word vorgesehen ist, werden der DocumentProperties-Auflistung drei benutzerdefinierte Dokumenteigenschaften hinzugefügt.

With ActiveDocument.CustomDocumentProperties 
    .Add Name:="LastModifiedBy", _ 
        LinkToContent:=True, _ 
        Type:=msoPropertyTypeString, _ 
        LinkSource:=Author
    .Add Name:="CustomNumber", _ 
        LinkToContent:=False, _ 
        Type:=msoPropertyTypeNumber, _ 
        Value:=1000 
    .Add Name:="CustomString", _ 
        LinkToContent:=False, _ 
        Type:=msoPropertyTypeString, _ 
        Value:="This is a custom property." 
    .Add Name:="CustomDate", _ 
        LinkToContent:=False, _ 
        Type:=msoPropertyTypeDate, _ 
        Value:=Date 
End With

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.