Como: Compilar condicionalmente com rastreamento e depurar

  • Artigo

Enquanto você está depurando um aplicativo durante o desenvolvimento, o rastreamento e depuração da saída vá para a janela Fechar programa no Visual Studio.No entanto, para incluir recursos de rastreamento em um aplicativo implantado, você deve compilar seus aplicativos com o instrumentadosRASTREAMENTOdiretiva de compilador habilitada.Isso permite que o código de rastreamento ser compilados em versão de lançamento do seu aplicativo.Se você não habilitar o RASTREAMENTO diretiva, todos os códigos de rastreamento será 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 associou atributos condicionais.Por exemplo, se a condicional de atributo para rastreamento é True, todas as instruções de rastreamento são incluídas dentro de um assembly (um arquivo compilado .exe ou .dll); se o Rastreamento atributo condicional é False, instruções de rastreamento não são incluídas.

Você pode fazer com que ambos o Rastreamento or Depurar atributo condicional ativado para uma compilação, ambos ou nenhum.Assim, há quatro tipos de compilação: Depurar, Rastreamento, ambos ou nenhum dos dois.Alguns compilações lançadas para a implantação de produção podem conter nenhum dos dois; compilações de depuração mais contenham ambos.

Você pode especificar as configurações do compilador para seu aplicativo de várias maneiras:

  • O propriedade páginas

  • A linha de comando

  • # CONST (para Visual Basic) e # define (para translation from VPE for Csharp)

Para alterar as configurações de compilar do propriedade caixa de diálogo páginas

  1. clicar com o botão direito do mouse no nó do projeto na O gerenciador de soluções.

  2. escolher Propriedades no menu de atalho.

    • No Visual Basic, clicar no Compilar guia no painel à esquerda da propriedade de página e, em seguida, clicar no Opções avançadas de compilação botão para exibir o Configurações de compilador avançadas caixa de diálogo.selecionar as caixas de seleção para as configurações de compilador você deseja ativar.desmarcar as caixas de seleção para as configurações que você deseja desabilitar.

    • Na translation from VPE for Csharp, clicar no Compilação guia no painel esquerdo da página de propriedades, em seguida, marque as caixas de seleção para as configurações de compilador para ativar.desmarcar as caixas de seleção para as configurações que você deseja desabilitar.

Compilar código instrumentado, usando a linha de comando

  • Defina uma comutador de compilador condicional na linha de comando.O compilador irá incluir rastreamento ou depurar código no executável.

    Por exemplo, a seguinte instrução de compilador inserida na linha de comando poderia incluir código de rastreamento em um executável compilado:

    Para o Visual Basic: vbc /r:sistema.dll/d: Trace = TRUE /d:depurar = FALSE MyApplication.vb

    Para translation from VPE for Csharp: CSC /r:sistema.dll/d: Trace /d:depurar = FALSE MyApplication.cs

    Dica:

    Para compilar o aplicativo mais de um arquivo, deixar um espaço em branco entre os nomes de arquivo, por exemplo, MyApplication1.vb MyApplication2.vb MyApplication3.vb or MyApplication1.cs MyApplication2.cs MyApplication3.cs.

    O significado das diretivas de compilação condicional usadas nos exemplos acima é sistema autônomo segue:

    Diretiva

    Significado

    vbc

    Compilador do Visual Basic

    csc

    Compilador translation from VPE for Csharp

    /r:

    Faz referência a um assembly externo (EXE ou DLL)

    /d:

    Define um símbolo de compilação condicional
    Observação:

    Você precisa escrever TRACE ou depurar com letras maiúsculas.Para obter mais informações sobre os comandos de compilação condicional, digite vbc /? (para Visual Basic) ou csc /? (para translation from VPE for Csharp) no aviso de comando. Para obter mais informações, consulte Criando a partir da linha de comando (C#) or Chamando o compilador de linha de comando (Visual Basic).

Para executar a compilação condicional usando # CONST ou # definir

  • Digite a demonstrativo apropriada para sua linguagem de programação na parte superior do arquivo de código-fonte.

    Linguagem

    demonstrativo

    Resultado

    Visual Basic

    # CONST TRACE = true

    Permite rastreamento

     

    # CONST TRACE = false

    Desativa o rastreamento

     

    # CONST depurar = true

    Ativa a depuração

     

    # CONST depurar = falso

    Desativa a depuração

    C#

    # define TRACE

    Permite rastreamento

     

    #undef TRACE

    Desativa o rastreamento

     

    # define depurar

    Ativa a depuração

     

    #undef depurar

    Desativa a depuração

Para desabilitar o rastreamento ou depuração

  1. Exclua a diretiva de compilador do seu código-fonte.

    - ou -

  2. Comente a diretiva de compilador.

    Observação:

    Quando estiver pronto para compilar, você pode escolher Compilação from the Compilação menu, ou use o método de linha de comando, mas sem digitar o d: para definir 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: Chamar o compilador de linha de comando

Conceitos

Introdução à instrumentação e rastreamento

Opções de rastreamento

Ouvintes de rastreamento

Outros recursos

Rastreamento e intrumentando aplicações