DocumentProperties.Add 方法 (Office)

建立新的自訂文件屬性。 您只能將新的文件屬性新增到自訂 DocumentProperties 集合。

語法

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

需要 expression。 代表 DocumentProperties 物件的變數。 自訂 DocumentProperties 物件。

參數

名稱	必要/選用	資料類型	描述
Name	必要	String	屬性的 Name 字串。
LinkToContent	必要	布林值	指定 LinkToContent 屬性是否連接到容器文件的內容。 如果此引數是 True，則需要 LinkSource 引數；如果是 False，則需要 Value 引數。
Type	選用	Variant	Type 屬性的資料類型。 可以是下列其中一項MsoDocProperties常數：msoPropertyTypeBoolean、msoPropertyTypeDate、msoPropertyTypeFloat、msoPropertyTypeNumber，或 msoPropertyTypeString。
Value	選用	Variant	Value 屬性的資料值，如果沒有連結到容器文件的內容。 將該值進行轉換以符合 Type 引數指定的資料類型，如果無法轉換，則會發生錯誤。 如果 LinkToContent 為 True，則會略過此引數，並會指定一個預設值給新的文件屬性，直到容器應用程式更新連結的屬性值 (通常在儲存文件時)。
LinkSource	選用	Variant	如果 LinkToContent 為 False，則略過。 LinkSource 屬性的來源。 容器應用程式會決定可使用的來源連結類型。 例如，DDE 連結使用的語法為 "Server|Document!Item"。

註解

如果您將自訂文件屬性新增到 DocumentProperties 集合，且該集合連結到 Office 文件中的指定值，則必須儲存文件，才能看到對 DocumentProperty 物件所做的變更。

範例

本範例的設計目的是在 Word 中執行，並將三個自訂文件屬性新增到 DocumentProperties 集合。

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

另請參閱

• DocumentProperties 物件成員

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。