Propriedade CustomActionData
Especifica os dados adicionais que podem ser avaliados por uma ação personalizada durante a instalação. Ações personalizadas são executadas no final de uma instalação e não podem acessar informações sobre a instalação; o CustomActionData propriedade para cada ação personalizada permite que você armazene informações sobre a instalação que pode ser lidos por essa ação personalizada.
Por exemplo, se o seu projeto de implantação incluído uma pesquisa de arquivos com um propriedade propriedade de FILESEARCH1, você poderia passar o valor retornado pela pesquisa de arquivo, definindo a CustomActionData propriedade para /MyFile = [FILESEARCH1]. Em sua ação personalizada, você poderia consultar a MyFile propriedade para recuperar o valor.
Comentários
O formato para o CustomActionData propriedade depende do tipo de ação personalizada.
Para ações personalizadas que são componentes de instalação (ProjectInstaller classes), o CustomActionData propriedade tem um formato de /name=value. Cada nome deve ser exclusivo e ter apenas um valor. Vários valores devem ser separados por um único espaço: /Name1 = valor1 /name2 = valor2. Se o valor tem um espaço nele, ele deve estar entre aspas: / nome = "um valor".
Propriedades do Windows Installer podem ser passadas usando a sintaxe entre colchetes: nome / = [PROPERTYNAME]. Propriedades do Windows Installer, como [TARGETDIR] que retornam um diretório, além dos colchetes você deve incluir aspas e uma barra invertida: / nome = "[TARGETDIR] \".
.gif "Observação")
ObservaçãoPara que uma ação personalizada deve ser tratado como um componente de instalação, o InstallerClass propriedade deve ser definida true. Para obter mais informações, consulte RunInstallerAttribute.
Para todas as outras ações personalizadas (. exe,. dll ou script), não há nenhum requisito de formato. Você pode passar qualquer seqüência de caracteres de CustomActionData propriedade, desde que você deve analisá-lo você mesmo em sua ação personalizada.
Solução de problemas
Se a ação personalizada depende de clientes, digitando um caminho para uma pasta de instalação, você poderá ver um ArgumentException mensagem de erro. Isso pode estar relacionado a um URL ou um diretório inválido.
Para evitar essa mensagem de erro, substitua a barra invertida com um espaço: / nome = "[TARGETDIR]". Em seguida, o valor de analisar e criar um caminho totalmente qualificado usando o Combine método.
Consulte também
Tarefas
Walkthrough: Usando uma ação personalizada para exibir uma mensagem na instalação