-debug (opções do compilador C#)-debug (C# Compiler Options)

A opção -debug faz o compilador gerar informações de depuração e colocá-las nos arquivos de saída.The -debug option causes the compiler to generate debugging information and place it in the output file or files.

SintaxeSyntax

-debug[+ | -]  
-debug:{full | pdbonly}  

ArgumentosArguments

+ | -+ | -
Especificar + ou apenas -debug faz o compilador gerar informações de depuração e colocá-las em um de banco de dados de programa (arquivo .pdb).Specifying +, or just -debug, causes the compiler to generate debugging information and place it in a program database (.pdb file). Especificar -, que será aplicado se -debug não for especificado, faz com que nenhuma informação de depuração seja criada.Specifying -, which is in effect if you do not specify -debug, causes no debug information to be created.

full | pdbonlyfull | pdbonly
Especifica o tipo de informações de depuração geradas pelo compilador.Specifies the type of debugging information generated by the compiler. O argumento completo, que será aplicado se -debug:pdbonly não for especificado, permite anexar um depurador ao programa em execução.The full argument, which is in effect if you do not specify -debug:pdbonly, enables attaching a debugger to the running program. Especificar pdbonly habilita a depuração do código-fonte quando o programa é iniciado no depurador, mas exibirá somente o assembler quando o programa em execução for anexado ao depurador.Specifying pdbonly allows source code debugging when the program is started in the debugger but will only display assembler when the running program is attached to the debugger.

ComentáriosRemarks

Use essa opção para criar builds de depuração.Use this option to create debug builds. Caso -debug, -debug+ ou -debug:full não sejam especificados, não será possível depurar o arquivo de saída do programa.If -debug, -debug+, or -debug:full is not specified, you will not be able to debug the output file of your program.

Caso -debug:full seja usado, lembre-se de que isso influenciará a velocidade e o tamanho do código otimizado JIT e haverá um pequeno impacto na qualidade do código com -debug:full.If you use -debug:full, be aware that there is some impact on the speed and size of JIT optimized code and a small impact on code quality with -debug:full. Recomenda-se -debug:pdbonly ou nenhum PDB para gerar código de versão.We recommend -debug:pdbonly or no PDB for generating release code.

Observação

Uma diferença entre -debug:pdbonly e -debug:full é que, com -debug:full, o compilador emite uma DebuggableAttribute, que é usada para avisar ao compilador JIT que as informações de depuração estão disponíveis.One difference between -debug:pdbonly and -debug:full is that with -debug:full the compiler emits a DebuggableAttribute, which is used to tell the JIT compiler that debug information is available. Portanto, haverá um erro se o código contiver DebuggableAttribute definido como false, caso -debug:full seja usado.Therefore, you will get an error if your code contains the DebuggableAttribute set to false if you use -debug:full.

Para obter informações sobre como configurar o desempenho de depuração de um aplicativo, consulte Facilitando a Depuração de uma Imagem.For more information on how to configure the debug performance of an application, see Making an Image Easier to Debug.

Para alterar o local do arquivo. pdb, consulte -PDB (opções do compilador C#).To change the location of the .pdb file, see -pdb (C# Compiler Options).

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual StudioTo set this compiler option in the Visual Studio development environment

  1. Abra a página Propriedades do projeto.Open the project's Properties page.

  2. Clique na página de propriedades Compilar.Click the Build property page.

  3. Clique no botão Avançado .Click the Advanced button.

  4. Modifique a propriedade Informações de Depuração.Modify the Debug Info property.

Para obter informações sobre como definir essa opção do compilador programaticamente, consulte DebugSymbols.For information on how to set this compiler option programmatically, see DebugSymbols.

ExemploExample

Coloque as informações de depuração no arquivo de saída app.pdb:Place debugging information in output file app.pdb:

csc -debug -pdb:app.pdb test.cs  

Confira tambémSee also