Freigeben über


CustomActionData-Eigenschaft

Aktualisiert: November 2007

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 ermöglicht die Speicherung installationsbezogener Informationen, die dann durch benutzerdefinierte Aktionen gelesen werden können.

Enthält Ihr Bereitstellungsprojekt z. B. eine Dateisuchfunktion mit einer Property-Eigenschaft von 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]\".

    Hinweis:

    Soll eine benutzerdefinierte Aktion als Installationskomponente behandelt werden, muss die InstallerClass-Eigenschaft auf true festgelegt werden.

  • 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.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Anzeigen einer Meldung bei der Installation mithilfe einer benutzerdefinierten Aktion

Gewusst wie: Erstellen von Installationskomponenten – Prozess höherer Ebene

Referenz

Eigenschaften für den Editor für benutzerdefinierte Aktionen

InstallerClass-Eigenschaft