Proprietà CustomActionData
Consente di specificare dati aggiuntivi che possono essere valutati da un'operazione personalizzata durante l'installazione. Le operazioni personalizzate vengono eseguite alla fine dell'installazione e non è previsto che accedano a informazioni sull'installazione. Tramite la proprietà CustomActionData, per ogni operazione personalizzata, è possibile memorizzare informazioni sull'installazione che tale operazione personalizzata è in grado di leggere.
Se ad esempio il progetto di distribuzione comprende una ricerca di file che utilizza la proprietà Property di FILESEARCH1, si potrebbe passare il valore restituito dalla ricerca impostando la proprietà CustomActionData su /MyFile=[FILESEARCH1]. e nell'operazione personalizzata si potrebbe interrogare la proprietà MyFile per recuperarne il valore.
Note
Il formato della proprietà CustomActionData dipende dal tipo di azione personalizzata.
Per le azioni personalizzate che sono componenti di installazione (classi ProjectInstaller), il formato della proprietà CustomActionData è /name=value. Ogni nome deve essere univoco e deve avere un solo valore. Se si specificano più valori, separarli con uno spazio: /nome1=valore1 /nome2=valor2. Se il valore include uno spazio, racchiuderlo tra virgolette doppie: /nome="un valore".
Le proprietà di Windows Installer possono essere passate utilizzando le parentesi quadre: /nome=[NOMEPROPRIETÀ]. Per proprietà di Windows Installer quali [TARGETDIR] che restituiscono una directory, oltre alle parentesi quadre è necessario includere le virgolette doppie e una barra rovesciata finale: /nome="[TARGETDIR]\".
Nota
Per fare in modo che un'azione personalizzata venga gestita come un componente di installazione, è necessario che la proprietà InstallerClass sia impostata su true. Per ulteriori informazioni, vedere RunInstallerAttribute.
Per tutte le altre operazioni personalizzate (EXE, DLL o script) non sono previsti requisiti di formato. È possibile passare qualunque stringa nella proprietà CustomActionData, poiché l'analisi deve essere eseguita nell'ambito dell'azione personalizzata.
Risoluzione dei problemi
Se l'azione personalizzata si basa sulla digitazione di un percorso di una cartella di installazione da parte dei clienti, è possibile che venga visualizzato un messaggio di errore ArgumentException. correlato a una directory o un URL non validi.
Per evitare questo messaggio di errore, sostituire la barra rovesciata con uno spazio: /nome =" [TARGETDIR] ". Analizzare quindi il valore e creare un percorso completo utilizzando il metodo Combine.