Свойство CustomActionData
Служит для определения дополнительных данных, которые можно обработать с помощью настраиваемого действия в ходе установки. Настраиваемые действия выполняются в конце установки и не могут получить сведения об установке; свойство CustomActionData для каждого настраиваемого действия позволяет хранить сведения об установке, которые могут читаться данным настраиваемым действием.
Например, если в проект развертывания включен поиск файла с использованием свойства Property файла FILESEARCH1, можно передать значение, возвращенное в результате поиска, задав для свойства CustomActionData значение "/MyFile=[FILESEARCH1]". В настраиваемом действии можно отправлять запрос для свойства MyFile, чтобы получить значение.
Заметки
Формат свойства CustomActionData зависит от типа настраиваемого действия.
Для настраиваемых действий, являющихся компонентами установки (классы ProjectInstaller) свойство CustomActionData принимает вид /name=value. Каждое имя должно быть уникальным и иметь только одно значение. Несколько значений должны быть разделены одним пробелом: /name1=value1 /name2=value2. Если значение содержит пробел, оно должно быть заключено в кавычки: /name="a value".
Свойства установщика Windows могут быть переданы с помощью синтаксиса в квадратных скобках: /name=[PROPERTYNAME]. Для свойств установщика Windows, таких как свойство [TARGETDIR], которое возвращает каталог, помимо скобок необходимо использовать кавычки и обратную косую черту: /name="[TARGETDIR]\".
Примечание
Для того чтобы настраиваемое действие воспринималось в качестве компонента установки, для свойства InstallerClass необходимо задать значение true.Дополнительные сведения см. в разделе RunInstallerAttribute.
Для других настраиваемых действий (файлы EXE, DLL или скрипт) требования, предъявляемые к формату, отсутствуют. Через свойство CustomActionData можно передать любую строку, поскольку необходимо самостоятельно проанализировать ее с помощью настраиваемого действия.
Устранение неполадок
Если настраиваемое действие относится к пользователям, указывающим путь к папке установки, то может появиться сообщение об ошибке ArgumentException. Причиной возникновения данного сообщения об ошибке может являться недопустимый каталог или URL-адрес.
Чтобы предотвратить появление этого сообщения об ошибке, замените обратную косую черту пробелом: /name="[TARGETDIR] ". Затем выполните разбор значения и создайте полный путь к папке установки с помощью метода Combine.
См. также
Задачи
Пошаговое руководство. Использование настраиваемого действия для отображения сообщения при установке