CustomActionData-Eigenschaft
Bestimmt zusätzliche Daten, die durch eine benutzerdefinierte Aktion während der Installation ausgewertet werden können. Benutzerdefinierte Aktionen werden nach Durchführung der Installation gestartet und können normalerweise nicht auf installationsbezogene Informationen zugreifen. Die CustomActionData-Eigenschaft für jede benutzerdefinierte Aktion ermöglicht die Speicherung installationsbezogener Informationen, die dann durch diese benutzerdefinierte Aktion gelesen werden können.
Enthält Ihr Bereitstellungsprojekt z. B. eine Dateisuchfunktion mit der Property-Eigenschaft FILESEARCH1, dann können Sie den bei der Dateisuche erhaltenen Wert übergeben, indem Sie die CustomActionData-Eigenschaft auf /MyFile=[FILESEARCH1] festlegen. Während der benutzerdefinierten Aktion können Sie die MyFile-Eigenschaft abfragen, um den Wert zu erhalten.
Hinweise
Das Format für die CustomActionData-Eigenschaft ist abhängig vom Typ der benutzerdefinierten Aktion.
Für benutzerdefinierte Aktionen, die Installationskomponenten (ProjectInstaller-Klassen) sind, weist die CustomActionData-Eigenschaft das Format /name=value auf. Jeder Name muss eindeutig sein und kann nur über einen Wert verfügen. Mehrere Werte müssen durch ein einzelnes Leerzeichen getrennt sein: /name1=value1 /name2=value2. Enthält der Wert ein Leerzeichen, muss er in Anführungszeichen gesetzt werden: /name="a value".
Windows Installer-Eigenschaften können unter Verwendung einer Syntax mit eckigen Klammern übergeben werden: /name=[PROPERTYNAME]. Bei Windows Installer-Eigenschaften wie [TARGETDIR], die ein Verzeichnis zurückgeben, müssen zusätzlich zu den Klammern noch Anführungszeichen und ein nachgestellter umgekehrter Schrägstrich eingegeben werden: /name="[TARGETDIR]\".
Tipp
Soll eine benutzerdefinierte Aktion als Installationskomponente behandelt werden, muss die InstallerClass-Eigenschaft auf true festgelegt werden. Weitere Informationen finden Sie unter RunInstallerAttribute.
Bei allen anderen benutzerdefinierten Aktionen (.exe, .dll oder Skript) gibt es keine besonderen Formatanforderungen. Sie können jede beliebige Zeichenfolge in die CustomActionData-Eigenschaft eingeben, die Sie dann in Ihrer benutzerdefinierten Aktion analysieren müssen.
Problembehandlung
Wenn für die benutzerdefinierte Aktion die Eingabe eines Pfads für einen Installationsordner erforderlich ist, wird möglicherweise eine ArgumentException-Fehlermeldung ausgegeben. Dies hängt möglicherweise mit einem ungültigen Verzeichnis oder einer ungültigen URL zusammen.
Um diese Fehlermeldung zu verhindern, ersetzen Sie den umgekehrten Schrägstrich durch ein Leerzeichen: /Name="[TARGETDIR]". Analysieren Sie dann den Wert, und erstellen Sie einen voll qualifizierten Pfad mithilfe der Combine-Methode.
Siehe auch
Aufgaben
Referenz
Eigenschaften für den Editor für benutzerdefinierte Aktionen