Build-gebeurtenissen opgeven

U kunt build-gebeurtenissen gebruiken om opdrachten op te geven die worden uitgevoerd voordat de build wordt gestart, vóór het koppelingsproces of nadat de build is voltooid.

Buildgebeurtenissen worden alleen uitgevoerd als de build deze punten in het buildproces heeft bereikt. Als er een fout optreedt in de build, treedt de gebeurtenis na de build niet op; als de fout zich voordoet vóór de koppelingsfase, treedt de pre-link noch de gebeurtenis na de build op. Bovendien, als er geen bestanden hoeven te worden gekoppeld, vindt de pre-koppelings gebeurtenis niet plaats. De pre-link gebeurtenis is ook niet beschikbaar in projecten die geen link-stap bevatten.

Als er geen bestanden hoeven te worden gebouwd, worden er geen build-gebeurtenissen uitgevoerd.

Voor algemene informatie over build-gebeurtenissen, zie Inzicht in aangepaste buildstappen en build-gebeurtenissen.

Een gebeurtenis voor het bouwen specificeren

1. Selecteer in Solution Explorerhet project waarvoor u de build-gebeurtenis wilt opgeven.

2. Open het dialoogvenster eigenschappenpagina's van het project. Zie C++-compiler instellen en eigenschappen bouwen in Visual Studiovoor meer informatie.

3. Selecteer in de map Build Events een eigenschappenpagina voor de build-gebeurtenis.

4. Geef de eigenschappen op die zijn gekoppeld aan de build-gebeurtenis:

   • Geef in de opdrachtregel een opdracht op alsof u deze opgeeft bij de opdrachtprompt. Geef een geldige opdracht of batchbestand en eventuele vereiste invoer- of uitvoerbestanden op. Geef de aanroepbatchopdracht op vóór de naam van een batchbestand om te garanderen dat alle volgende opdrachten worden uitgevoerd.

     Meerdere invoer- en uitvoerbestanden kunnen symbolisch worden opgegeven met MSBuild-macro's. Zie Algemene macro's voor build-opdrachten en eigenschappen voor informatie over het opgeven van de locatie van bestanden of de namen van sets bestanden.

     Omdat het teken '%' is gereserveerd door MSBuild, vervangt u elk escape-teken door de % hexadecimale escapereeks als u een omgevingsvariabele opgeeft. Vervang bijvoorbeeld %WINDIR% door %25WINDIR%25. MSBuild vervangt elke %25 reeks door het % teken voordat deze toegang heeft tot de omgevingsvariabele.

   • Typ in Beschrijving een beschrijving voor deze gebeurtenis. De beschrijving wordt afgedrukt in het uitvoervenster wanneer deze gebeurtenis plaatsvindt.

   • Geef in Uitgesloten van buildJa op als u niet wilt dat de gebeurtenis wordt uitgevoerd.

Zie ook

Informatie over aangepaste buildstappen en build-gebeurtenissen
Algemene macro's voor bouwopdrachten en eigenschappen
Problemen met buildaanpassingen oplossen