Projectinstellingen voor een C++-foutopsporingsconfiguratie
U kunt de projectinstellingen voor een C- of C++-foutopsporingsconfiguratie wijzigen in het dialoogvenster eigenschappenpagina's, zoals beschreven in Instructies: Foutopsporings- en releaseconfiguraties instellen. De volgende tabellen tonen waar u debugger-instellingen kunt vinden in het dialoogvenster Eigenschapspagina's.
Notitie
De foutopsporingsprojectinstellingen in de Configuratie-eigenschappen/foutopsporing categorie verschillen voor UWP-apps en voor onderdelen die zijn geschreven in C++. Zie Een foutopsporingssessie (VB, C#, C++ en XAML) starten.
Elke instelling voor foutopsporingseigenschappen wordt automatisch geschreven en opgeslagen in het bestand per gebruiker (.vcxproj.user) voor uw oplossing wanneer u uw oplossing opslaat.
Geef op welk foutopsporingsprogramma dat moet worden gebruikt om in het Foutopsporingsprogramma de keuzelijst te starten, zoals in de volgende tabel staat beschreven. Uw keuze is van invloed op welke eigenschappen zichtbaar zijn.
Map Configuratie-eigenschappen (categorie foutopsporing)
| instellen | Beschrijving |
|---|---|
| Foutopsporingsprogramma om te starten | Hiermee geeft u het foutopsporingsprogramma op dat moet worden uitgevoerd, met de volgende opties: - Lokaal Windows-foutopsporingsprogramma - Externe Windows-foutopsporingsprogramma - foutopsporingsprogramma voor webbrowsers - foutopsporingsprogramma voor webservices |
| opdracht (lokaal Windows-foutopsporingsprogramma) | Hiermee geeft u de opdracht om het programma te starten dat u aan het debuggen bent op de lokale computer. |
| Remote Command (Windows Remote Debugger) | Het pad voor de .exe op de externe computer. Voer het pad in, net zoals u het op de externe computer zou invoeren. |
|
Opdrachtargumenten (Lokaal Windows-Foutopsporingsprogramma) Externe Opdrachtargumenten (Externe Windows Foutopsporingsprogramma) |
- Hiermee geeft u argumenten op voor het programma dat u aan het debuggen bent. Zie Opdrachtregelargumenten naar een te debuggen programma (C++)verzenden voor meer informatie over het instellen van opdrachtregelargumenten. U kunt de volgende omleidingsoperators in dit vak gebruiken: < fileLeest stdin uit bestand. > fileHiermee wordt stdout naar het bestand geschreven. >> fileHiermee voegt u stdout toe aan het bestand. 2> fileSchrijft stderr naar bestand. 2>> fileVoegt stderr toe aan bestand. 2> &1 Verzendt stderr-uitvoer (2) naar dezelfde locatie als stdout (1). 1> &2 Verzendt stdout-uitvoer (1) naar dezelfde locatie als stderr (2). In de meeste gevallen zijn deze operators alleen van toepassing op consoletoepassingen. Als u escape-tekens in de opdracht wilt gebruiken, kunt u ASCII-waarden gebruiken, zoals %25 om %te vervangen. Als u de Start Debugging opdracht gebruikt, worden dubbele aanhalingstekens gebruikt om de voorgaande opdrachten te ontsnappen, zoals "<" om <te vervangen. |
| werkmap | Geeft de werkmap op van het programma dat wordt gedebugt, ten opzichte van de projectmap waar uw EXE zich bevindt. Als u dit leeg laat, is de werkmap de projectmap. Voor externe foutopsporing bevindt de projectmap zich op de externe server. |
| koppelen (lokaal Windows-foutopsporingsprogramma en extern Windows-foutopsporingsprogramma) | Hiermee geeft u op of de toepassing moet worden gestart of ermee verbonden. De standaardinstelling is Nee. |
| Remote Server Name (Remote Windows Debugger) | Hiermee geeft u de naam op van een computer (anders dan die van u) waarop u fouten wilt opsporen in een toepassing. De macrowaarde voor RemoteMachine Build is ingesteld op de waarde van deze eigenschap; raadpleeg voor meer informatie Macro's voor buildopdrachten en eigenschappen. |
| Verbinding (Externe Windows-debugger) | Hiermee kunt u schakelen tussen standaardverbindingstypen en verbindingstypen zonder verificatie voor externe foutopsporing. Geef een externe computernaam op in het vak Externe servernaam. Verbindingstypen zijn onder andere: - Afstandsbediening met Windows-verificatie - extern zonder verificatie Opmerking Externe foutopsporing zonder verificatie kan de externe computer kwetsbaar maken voor beveiligingsschendingen. Windows-verificatiemodus is veiliger. Zie setup voor externe foutopsporingvoor meer informatie. |
| HTTP-URL- (foutopsporingsprogramma voor webservices en foutopsporingsprogramma voor webbrowsers) | Hiermee geeft u de URL op waar het project dat u aan het debuggen bent zich bevindt. |
| foutopsporingsprogrammatype | Hiermee geeft u het type foutopsporingsprogramma aan dat moet worden gebruikt: Alleen Native, Alleen Beheerd, Alleen GPU, Gemengd, Automatisch (standaard), of Script. - Native Only is voor onbeheerde C++-code. - Alleen beheerde is bedoeld voor code die wordt uitgevoerd onder de algemene taalruntime (beheerde code). - Mixed roept foutopsporingsprogramma's aan voor zowel beheerde als onbeheerde code. - Automatisch bepaalt het foutopsporingsprogrammatype op basis van compiler- en EXE-gegevens. - Script een foutopsporingsprogramma voor scripts aanroept. - GPU Alleen is bedoeld voor C++ AMP-code die wordt uitgevoerd op een GPU-apparaat of op de DirectX-referentierasterizer. Zie GPU-code voor foutopsporing. |
| Environment (Lokaal Windows-foutopsporingsprogramma en Extern Windows-foutopsporingsprogramma) | Hiermee geeft u omgevingsvariabelen op voor het programma dat u foutopsporing uitvoert. Gebruik de syntaxis van de standaardomgevingsvariabele (bijvoorbeeld PATH="%SystemRoot%\..."). Deze variabelen overschrijven de systeemomgeving of worden samengevoegd met de systeemomgeving, afhankelijk van de instelling Omgeving samenvoegen. Wanneer u in de rechterkolom klikt, wordt een 'Bewerken...' weergegeven. Selecteer die koppeling om de eigenschapseditor te openen en omgevingsvariabelen te bewerken. Als u meerdere omgevingsvariabelen wilt toevoegen, gebruikt u de Eigenschappeneditor en voegt u één variabele per regel toe. |
| Samenvoegomgeving (Lokale Windows-debugger) | Bepaalt of de variabelen die zijn opgegeven in het vak Omgeving worden samengevoegd met de omgeving die is gedefinieerd door het besturingssysteem. De standaardinstelling is Ja. |
| SQL-foutopsporing (allemaal behalve MPI-clusterdebugger) | Hiermee schakelt u foutopsporing van SQL-procedures vanuit uw Visual C++-toepassing in. De standaardinstelling is Nee. |
| Foutopsporingsversnellertype (alleen GPU-foutopsporing) | Hiermee specificeert u de GPU die u wilt gebruiken voor foutopsporing. Als u apparaatstuurprogramma's installeert voor compatibele GPU-apparaten, voegt u extra opties toe. De standaardinstelling is GPU - Software Emulator. |
| GPU-standaardonderbrekingspuntgedrag (alleen GPU-foutopsporing) | Hiermee geeft u op of een onderbrekingspuntgebeurtenis moet worden gegenereerd voor elke thread in een SIMD-warp. De standaardinstelling is om de onderbrekingspunt gebeurtenis slechts eenmaal per warp te verhogen. |
| Amp Standaardversneller | Hiermee geeft u de standaard AMP-accelerator op bij het opsporen van fouten in GPU-code. Kies WARP-softwareversneller om te onderzoeken of een probleem wordt veroorzaakt door de hardware of een stuurprogramma in plaats van uw code. |
| Implementatiedirectory (Remote Windows Debugger) | Hiermee specificeert u het pad op de externe computer waar de projectuitvoer wordt gekopieerd voordat het wordt gestart. Het pad kan een netwerkshare op de externe computer zijn of kan een pad naar een map op de externe computer zijn. De standaardinstelling is leeg, wat betekent dat de projectuitvoer niet naar een netwerkshare wordt gekopieerd. Als u de implementatie van de bestanden wilt inschakelen, moet u ook het selectievakje Implementeren in het dialoogvenster Configuration Manager inschakelen. Zie Procedure: Configuraties maken en bewerkenvoor meer informatie. |
| Aanvullende bestanden voor het implementeren van (Extern Windows-foutopsporingsprogramma) | Als de eigenschap Deployment Directory is ingesteld, is dit een door puntkomma's gescheiden lijst met extra mappen of bestanden die u naar de implementatiemap wilt kopiëren. De standaardinstelling is leeg, wat betekent dat er geen extra mappen of bestanden naar de implementatiemap worden gekopieerd. Als u de inhoud van een map naar dezelfde map in de implementatiemap wilt kopiëren, geeft u een mapnaam op. Als u de implementatie van de bestanden wilt inschakelen, moet u ook het selectievakje Implementeren in het dialoogvenster Configuration Manager inschakelen. Zie Procedure: Configuraties maken en bewerkenvoor meer informatie. |
| Visual C++ Runtime-bibliotheken voor foutopsporing implementeren (Extern Windows-foutopsporingsprogramma) | Als de eigenschap Deployment Directory is ingesteld, geeft u aan of de Visual C++ runtime-bibliotheken voor foutopsporing voor het huidige platform moeten worden gekopieerd naar de netwerkshare. De standaardinstelling is Ja. |
Map C/C++ (algemene categorie)
| Instelling | Beschrijving |
|---|---|
| Debug Information Format (/Z7, /Zd, Zi, /ZI) | Hiermee geeft u het type foutopsporingsgegevens op dat moet worden gemaakt voor het project. Met de standaardoptie (/ZI) maakt u een programmadatabase (PDB) in de compatibele indeling Bewerken en Doorgaan. Zie /Z7, /Zd, /Zi, /ZI (foutopsporingsindeling)voor meer informatie. |
C/C++-map (optimalisatiecategorie)
| Instelling | Beschrijving |
|---|---|
| Optimalisatie | Hiermee geeft u op of de compiler de code moet optimaliseren die wordt geproduceerd. Optimalisatie wijzigt de code die wordt uitgevoerd. Geoptimaliseerde code komt niet meer overeen met de broncode, waardoor foutopsporing moeilijker wordt. De standaardoptie (Uitgeschakeld (/0d)) onderdrukt optimalisatie. U kunt ontwikkelen met optimalisatie onderdrukt en deze vervolgens inschakelen wanneer u de productieversie van uw code maakt. |
Linkermap (categorie foutopsporing)
| Instelling | Beschrijving |
|---|---|
| Foutopsporingsgegevens genereren (/DEBUG-) | Hiermee geeft u aan dat de linker foutopsporingsgegevens moet opnemen in de indeling die is opgegeven door /Z7, /Zd, Zi of /ZI. |
| Programmadatabasebestand genereren (/PDB:name) | Geef in dit vak de naam op van een PDB-bestand (program database). U moet ZI of /Zi selecteren voor het formaat van foutopsporingsinformatie. |
| Strip Private Symbols (/PDBSTRIPPED:bestandsnaam) | Geef de naam op van een PDB-bestand in dit vak als u geen persoonlijke symbolen wilt opnemen in het PDB-bestand. Met deze optie maakt u een tweede PDB-bestand wanneer u uw programma-installatiekopieën bouwt met een van de compiler- of linkeropties die een PDB-bestand genereren, zoals /DEBUG, /Z7, /Zd. Of /Zi. In dit tweede PDB-bestand worden symbolen weggelaten die u niet naar uw klanten wilt verzenden. Zie /PDBSTRIPPED (Strip private symbols)voor meer informatie. |
| mapbestand genereren (/MAP) | Geeft aan dat de linker een kaartbestand moet genereren tijdens het koppelen. De standaardinstelling is Nee. Zie /MAP (Mapfile genereren)voor meer informatie. |
| mapbestandsnaam (/MAP:naam) | Als u Mapbestand genereren kiest, kunt u het kaartbestand in dit vak opgeven. Zie /MAP (Mapfile genereren)voor meer informatie. |
| Kaart Exporteren (/MAPINFO:EXPORTS) | Bevat geëxporteerde functies in het kaartbestand. De standaardinstelling is Nee. Zie /MAPINFO (Include Information in Mapfile)voor meer informatie. |
| Debuggable Assembly (/ASSEMBLYDEBUG) | Hiermee geeft u instellingen voor de optie Linker /ASSEMBLYDEBUG. Mogelijke waarden zijn: - Geen foutopsporingsbaar kenmerk verzonden. - Runtime-tracering en schakel optimalisaties (/ASSEMBLYDEBUG) uit. Dit is de standaardinstelling. - Geen runtime bijhouden en optimalisaties uitschakelen (/ASSEMBLYDEBUG:DISABLE). - <erven van ouder of projectstandaarden>. - Zie /ASSEMBLYDEBUG (Add DebuggableAttribute)voor meer informatie. |
U kunt deze instellingen programmatisch wijzigen in de map Configuratie-eigenschappen (categorie voor foutopsporing) met behulp van de interface Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings. Zie VCDebugSettingsvoor meer informatie.
Andere projectinstellingen
Als u fouten wilt opsporen in projecttypen, zoals statische bibliotheken en DLL's, moet uw Visual Studio-project de juiste bestanden kunnen vinden. Wanneer broncode beschikbaar is, kunt u statische bibliotheken en DLL's als afzonderlijke projecten toevoegen aan dezelfde oplossing, om foutopsporing eenvoudiger te maken. Zie Maken en gebruiken van een DLL- (Dynamic Link Library) en Een maken met behulp van een statische bibliotheekvoor meer informatie over het maken van deze projecttypen. Als er broncode beschikbaar is, kunt u ook een nieuw Visual Studio-project maken door File>New>Project From Existing Codete kiezen.
Zie Debugging DLL-projectenvoor het opsporen van fouten in DLL-bestanden die buiten uw project vallen. Als u fouten wilt opsporen in uw eigen DLL-project, maar geen toegang hebt tot het project voor de aanroepende toepassing, raadpleegt u Fouten opsporen vanuit een DLL-project.