CustomActionData, propriété
Indique que des données supplémentaires peuvent être évaluées par une action personnalisée pendant l'installation. Les actions personnalisées sont exécutées à la fin d'une installation et ne peuvent pas accéder aux informations durant l'installation. La propriété CustomActionData pour chaque action personnalisée permet de stocker les informations sur l'installation qui peuvent être lues par l'action personnalisée.
Par exemple, si votre projet de déploiement inclut une recherche de fichier dont la propriété Property a la valeur FICHIERRECHERCHER1, vous pouvez passer la valeur retournée par la recherche en affectant à la propriété CustomActionData la valeur /MonFichier=[FICHIERRECHERCHER1]. Dans l'action personnalisée, vous pouvez interroger la propriété MyFile pour en récupérer la valeur.
Notes
Le format de la propriété CustomActionData est fonction du type de l'action personnalisée.
Pour les actions personnalisées qui sont des composants d'installation (classes ProjectInstaller), la propriété CustomActionData prend le format /name=value. Chaque nom doit être unique et avoir une seule valeur. Insérez un espace pour séparer deux valeurs : /nom1=valeur1 /nom2=valeur2. Si la valeur contient elle-même un espace, placez-la entre guillemets : /nom="une valeur"
Les propriétés de Windows Installer peuvent être passées à l'aide d'expressions entre crochets : /nom=[NOMPROPRIÉTÉ]. Pour les propriétés de Windows Installer comme [TARGETDIR] qui retournent un répertoire, en plus des crochets, vous devez ajouter des guillemets et une barre oblique inverse de fin : /nom="[RÉPERTOIRECIBLE]\".
Notes
Pour qu'une action personnalisée puisse être traitée comme un composant d'installation, la propriété InstallerClass doit avoir la valeur true. Pour plus d'informations, consultez RunInstallerAttribute.
Pour toutes les autres actions personnalisées (.exe, .dll ou script), il n'existe aucun format requis. Vous pouvez passer la chaîne de votre choix dans la propriété CustomActionData, étant donné que vous devez l'analyser vous-même dans l'action personnalisée.
Dépannage
Si votre action personnalisée requiert que les clients tapent un chemin d'accès à un dossier d'installation, un message d'erreur ArgumentException peut s'afficher. Il peut correspondre à un répertoire ou une URL non valide.
Pour empêcher ce message d'erreur, remplacez la barre oblique inverse par un espace : /name= "[TARGETDIR]". Ensuite, analysez la valeur et créez un chemin qualifié complet à l'aide de la méthode Combine.