Partilhar via


/Define ( Opçõesdo compilador de C#)

O /define define a opção name como arquivos de um símbolo em todo o código fonte do programa.

/define:name[;name2]

Argumentos

  • name, name2
    O nome de um ou mais símbolos que você deseja definir.

Comentários

O /define opção tem o mesmo efeito que usar um # define diretiva de pré-processamento, exceto que a opção de compilador está em vigor para todos os arquivos no projeto. Um símbolo permanecerá definido em um arquivo de origem até que uma #undef a diretiva no arquivo de origem remove a definição. Quando você usa a opção, /define um #undef diretiva em um arquivo não tem efeito sobre outros arquivos de código-fonte do projeto.

Você pode usar os símbolos criados por essa opção com # if, # else, # elif, e # endif para compilar arquivos de origem condicionalmente.

/dé a forma abreviada de /define.

Você pode definir vários símbolos com /define usando um ponto e vírgula ou uma vírgula para separar nomes de símbolo. Por exemplo:

/define:DEBUG;TUESDAY

O compilador C# si define sem símbolos ou macros que você pode usar em seu código de origem; todas as definições de símbolo devem ser definido pelo usuário.

ObservaçãoObservação

C# #define não permite que um símbolo a ser dado um valor, como em linguagens como C++. Por exemplo, #define não pode ser usado para criar uma macro ou para definir uma constante. Se você precisar definir uma constante, use um enum variável. Se você deseja criar uma macro de estilo C++, considere alternativas como, por exemplo, os genéricos. Como as macros são notoriamente propenso a erros, C# retira a permissão de seu uso mas oferece alternativas mais seguras.

Para definir esta opção de compilador no ambiente de desenvolvimento Visual Studio

  1. Abra o projeto Propriedades página.

  2. No Build guia, digite o símbolo que deve ser definido na símbolos de compilação condicional caixa. Por exemplo, se você estiver usando o exemplo de código a segue, basta digitar xx na caixa de texto.

Para obter informações sobre como definir esta opção de compilador programaticamente, consulte DefineConstants.

Exemplo

// preprocessor_define.cs
// compile with: /define:xx
// or uncomment the next line
// #define xx
using System;
public class Test 
{
    public static void Main() 
    {
        #if (xx) 
            Console.WriteLine("xx defined");
        #else
            Console.WriteLine("xx not defined");
        #endif
    }
}

Consulte também

Outros recursos

C# Compiler Options

Propriedades de Projeto (Visual Studio)