Como: Compilar condicionalmente com rastreamento e depuração
Enquanto você estiver depurando um aplicativo durante o desenvolvimento, o rastreamento e depuração da saída vá para a janela de saída na Visual Studio. No entanto, para incluir recursos de rastreamento em um aplicativo implantado, você deve compilar seus aplicativos instrumentados com o rastreamento a diretiva de compilador habilitada. Isso permite que o código de rastreamento ser compilado em versão de lançamento do seu aplicativo. Se você não habilitar o rastreamento diretiva, todo o código de rastreamento é ignorado durante a compilação e não está incluído no código executável que será implantado.
O rastreamento e depuração métodos têm associados a atributos condicionais. Por exemplo, se o condicional atributo para rastreamento é true, todas as instruções de rastreamento são incluídas dentro de um assembly (um compilado. exe ou. dll); Se o rastreamento atributo conditional é false, instruções de rastreamento não são incluídas.
Você pode ter um a rastreamento ou Debug atributo conditional ativado para uma compilação, ambos ou nenhum. Portanto, existem quatro tipos de compilação: Debug, rastreamento, ambos ou nenhum. Algumas compilações lançadas para a implantação de produção podem conter nenhum; compilações de depuração mais contenham ambos.
Você pode especificar as configurações do compilador para seu aplicativo de várias maneiras:
As páginas de propriedade
A linha de comando
# CONST (para Visual Basic) e # define (para C#)
Para alterar as configurações de compilação da caixa de diálogo de páginas de propriedade
Clique com o botão direito no nó do projeto em Solution Explorer.
Escolha Propriedades no menu de atalho.
Na Visual Basic, clique o compilar guia no painel esquerdo da página de propriedades e clique no Advanced Compile Options botão para exibir a Advanced Compiler Settings caixa de diálogo. Marque as caixas de seleção para as configurações do compilador que você deseja ativar. Desmarque as caixas de seleção para as configurações que você deseja desativar.
Na C#, clique o Build no painel esquerdo da página de propriedades e selecione as caixas de seleção para as configurações do compilador que você deseja ativar. Desmarque as caixas de seleção para as configurações que você deseja desativar.
Para compilar o código instrumentado, usando a linha de comando
Defina um comutador de compilador condicional na linha de comando. O compilador incluirá o rastreamento ou depurar o código no executável.
Por exemplo, a seguinte instrução de compilador inserida na linha de comando poderia incluir o seu código de rastreamento em um executável compilado:
Para Visual Basic: /r:System.dll de arquivo Vbc /d: Trace = TRUE /d:DEBUG = FALSE MyApplication.vb
Para C#: /d:DEBUG do CSC /r:System.dll /d: Trace = FALSE MyApplication.cs
Observação
Para compilar a mais de um arquivo de aplicativo, deixar um espaço em branco entre os nomes de arquivo, por exemplo, MyApplication3.vb de MyApplication2.vb MyApplication1.vb ou MyApplication3.cs de MyApplication2.cs MyApplication1.cs.
O significado das diretivas de compilação condicional usados nos exemplos acima é o seguinte:
Diretiva
Significado
vbc
Compilador de Visual Basic
csc
Compilador C#
/r:
Referencia um assembly externo (EXE ou DLL)
/d:
Define um símbolo de compilação condicional
Observação
Você precisa escrever o rastreamento ou depuração com letras maiúsculas.Para obter mais informações sobre os comandos de compilação condicional, digite vbc /? (para Visual Basic) ou csc /? (para C#) no prompt de comando.Para obter mais informações, consulte a construção da linha de comando (C#) ou chamando o compilador de linha de comando (Visual Basic).
Para executar a compilação condicional usando # CONST ou # definir
Digite a instrução apropriada para sua linguagem de programação na parte superior do arquivo de código de origem.
Linguagem
Instrução
Resultado
Visual Basic
# CONST TRACE = true
Permite rastreamento
# CONST TRACE = false
Desativa o rastreamento
# CONST DEBUG = true
Ativa a depuração
# CONST DEBUG = false
Desativa a depuração
C#
# define TRACE
Permite rastreamento
RASTREAMENTO de #undef
Desativa o rastreamento
# define DEBUG
Ativa a depuração
DEPURAÇÃO de #undef
Desativa a depuração
Para desabilitar o rastreamento ou depuração
Exclua a diretiva de compilador do seu código fonte.
- ou -
Comente a diretiva de compilador.
Observação
Quando estiver pronto para compilar, você pode escolher Build da Build menu, ou use o método de linha de comando, mas sem digitar a d: Para definir os símbolos de compilação condicional.
Consulte também
Tarefas
Como: Configurar opções de rastreamento
Como: Adicionar instruções de rastreamento ao código do aplicativo
Como: definir variáveis de ambiente
Como: Invocar o compilador de linha de comando (Visual Basic)
Conceitos
Introdução à instrumentação e rastreamento