Angeben von Buildereignissen

Aktualisiert: November 2007

Mithilfe von Buildereignissen können Befehle festgelegt werden, die vor dem Buildvorgang, vor dem Verknüpfungsvorgang oder nach dem Buildvorgang ausgeführt werden.

Buildereignisse werden nur dann ausgeführt, wenn im Buildvorgang diese Punkte erfolgreich erreicht werden. Wenn während des Buildvorgangs ein Fehler ausgegeben wird, tritt kein Postbuildereignis auf. Wenn der Fehler vor der Verknüpfungsphase auftritt, wird weder das Prälinkereignis noch das Postbuildereignis erstellt. Das Prälinkereignis tritt außerdem nicht auf, wenn keine Dateien verknüpft werden müssen. In Projekten, die keinen Verknüpfungsschritt enthalten, tritt das Prälinkereignis ebenfalls nicht auf.

Wenn keine Dateien erstellt werden müssen, treten keine Buildereignisse auf.

Allgemeine Informationen zu Buildereignissen finden Sie unter Grundlagen benutzerdefinierter Buildschritte und Buildereignisse.

So legen Sie ein Buildereignis fest

  1. Wählen Sie im Projektmappen-Explorer das Projekt aus, für das das Buildereignis festgelegt werden soll.

  2. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Festlegen von Visual C++-Projekteigenschaften.

  3. Wählen Sie im Ordner Buildereignisse eine Buildereignis-Eigenschaftenseite aus.

  4. Legen Sie die dem Buildereignis zugeordneten Eigenschaften fest:

    • Geben Sie in der Befehlszeile die Syntax des Buildereignisses an. Diese Syntax kann jeden in der Befehlszeile oder in einer BAT-Datei zulässigen Befehl enthalten. Sie können auch Makros für Buildbefehle und Buildeigenschaften verwenden, um den Speicherort von Dateien festzulegen oder den tatsächlichen Namen der Eingabedatei abzurufen, falls mehrere Elemente ausgewählt wurden. Dem Namen einer Batchdatei sollte call vorangestellt werden, damit alle folgenden Befehle ausgeführt werden.

    • Geben Sie unter Beschreibung eine Beschreibung für dieses Ereignis ein. Diese wird beim Auftreten dieses Ereignisses im Ausgabefenster angezeigt.

    • Geben Sie unter Vom Build ausschließen die Option Ja an, wenn das Ereignis nicht ausgeführt werden soll.

Siehe auch

Referenz

Grundlagen benutzerdefinierter Buildschritte und Buildereignisse

Problembehandlung bei benutzerdefinierten Buildschritten und Buildereignissen

Weitere Ressourcen

Makros für Buildbefehle und -eigenschaften