CustomActionData 屬性

指定可於安裝時由自訂動作評估的額外資料。 自訂動作於安裝結束時執行,並且無法存取有關安裝的資訊。每個自訂動作的 CustomActionData 屬性都可讓您透過自訂動作,儲存安裝的相關資訊。

例如,如果您的部署專案中包括 Property 屬性為 FILESEARCH1 的檔案搜尋,可經由設定 CustomActionData 屬性為 /MyFile=[FILESEARCH1],以傳送檔案搜尋的傳回值。 在您的自訂動作中,可查詢 MyFile 屬性以擷取值。

備註

CustomActionData 屬性的格式依自訂動作的型別而定。

  • 若自訂動作是安裝元件 (ProjectInstaller 類別),CustomActionData 屬性將使用 /name=value 的格式。 每一個名稱必須是唯一的且只有一個值。 多個值必須以單一空格隔開:/name1=value1 /name2=value2。 如果該值中有空格,則必須以雙引號括起來:/name="a value"。

    Windows Installer 屬性可使用有括號的語法傳送:/name=[PROPERTYNAME]。 對於 Windows Installer 屬性 (例如傳回目錄的 [TARGETDIR]),除了括號以外,您還必須加入雙引號和後方的反斜線:/name="[TARGETDIR]\"。

    注意事項注意事項

    為了將自訂動作視為安裝元件,InstallerClass 屬性必須設定為 true。 如需詳細資訊,請參閱RunInstallerAttribute

  • 對於其他所有自訂動作 (.exe、.dll 或指令碼),並無格式需求。 既然您必須在自訂動作中自行剖析,就可以在 CustomActionData 屬性中傳送任何字串。

疑難排解

如果您的自訂動作依賴客戶輸入安裝資料夾的路徑,您可能會看到 ArgumentException 錯誤訊息。 這可能與無效的目錄或 URL 有關。

若要避免這個錯誤訊息,請以空格取代反斜線:/name="[TARGETDIR] "。 然後,剖析該值,並使用 Combine 方法建立完整路徑。

請參閱

工作

逐步解說:使用自訂動作在安裝時顯示訊息

參考

自訂動作編輯器的屬性

InstallerClass 屬性