Dominando Diretivas de Pré-processador em C#: Guia Prático

Dominando Diretivas de Pré-processador em C#

Descubra como as diretivas de pré-processador em C# moldam a compilação, controlam fluxo e tratam erros. Este guia cobre cada diretiva, sua sintaxe, exemplos reais e boas práticas.

Diretivas de pré-processador são comandos que o compilador avalia antes da compilação real. Elas ditam quais seções de código são incluídas, como avisos e erros são tratados, e podem até modificar a visão do compilador sobre números de linha e nomes de arquivo.

Em C#, uma diretiva começa com o símbolo # e ocupa uma única linha, terminada por nova linha em vez de ponto e vírgula.

#if expressão código #endif

#if expr1 código1 #elif expr2 código2 #endif

#if expr1 código1 #else código2 #endif

#if expr código #endif

#define SÍMBOLO

#undef SÍMBOLO

#warning Sua mensagem de aviso

#error Sua mensagem de erro

#line 50 "ProgramaFalso.cs" #endif

#region Descrição código #endregion

#pragma warning disable #endif

Definindo e Removendo Símbolos

• #define cria um símbolo que avalia como verdadeiro em blocos #if.
• #undef remove um símbolo, fazendo-o avaliar como falso.

Exemplo: Definindo um Símbolo

#define TESTANDO

Exemplo: Removendo um Símbolo

#undef TESTANDO

Compilação Condicional com #if, #elif, #else e #endif

• #if testa uma expressão; código dentro é compilado apenas se a expressão for verdadeira.
• Expressões podem usar operadores lógicos (&&, ||, !) e símbolos.
• #elif permite testar múltiplas condições sequencialmente.
• #else executa quando nenhuma das condições anteriores é satisfeita.
• #endif encerra o bloco condicional.

Exemplo Prático

#define CSHARP #undef PYTHON using System; namespace Diretiva { class DiretivaCondicional { static void Main(string[] args) { #if (CSHARP && PYTHON) Console.WriteLine("CSHARP e PYTHON estão definidos"); #elif (CSHARP && !PYTHON) Console.WriteLine("CSHARP está definido, PYTHON não está definido"); #elif (!CSHARP && PYTHON) Console.WriteLine("PYTHON está definido, CSHARP não está definido"); #else Console.WriteLine("CSHARP e PYTHON não estão definidos"); #endif } } }

Saída: CSHARP está definido, PYTHON não está definido

Gerando Avisos e Erros

• #warning emite um aviso definido pelo usuário, mas permite que o programa continue.
• #error emite um erro fatal, interrompendo a compilação.

Exemplo de Aviso

using System; namespace Diretivas { class AvisoDiretiva { public static void Main(string[] args) { #if (!CSHARP) #warning CSHARP não está definido #endif Console.WriteLine("Exemplo de diretiva #warning"); } } }

A saída inclui uma linha de aviso, mas o texto do console é impresso.

Exemplo de Erro

using System; namespace Diretiva { class Erro { public static void Main(string[] args) { #if (!CSHARP) #error CSHARP não está definido #endif Console.WriteLine("Exemplo de diretiva #error"); } } }

Saída: build falha com erro em tempo de compilação; a linha final do console nunca é executada.

Personalizando Locais de Diagnóstico com #line

• Altera o número de linha e nome de arquivo reportados para avisos ou erros subsequentes.

Exemplo

using System; namespace Diretiva { class LinhaDemo { public static void Main(string[] args) { #line 200 "OutroPrograma.cs" #warning Aviso real gerado por Programa.cs na linha 10 } } }

Resultado: Aviso aparece como OutroPrograma.cs(200,22): warning CS1030: ...

Organizando Código com #region e #endregion

• Agrupa blocos de código relacionados, que podem ser recolhidos em editores.
• Não podem se sobrepor a outro #region, mas podem residir dentro de um bloco condicional.

Exemplo

using System; namespace Diretiva { class RegiaoDemo { public static void Main(string[] args) { #region Olá Console.WriteLine("Olá"); Console.WriteLine("Olá"); Console.WriteLine("Olá"); Console.WriteLine("Olá"); Console.WriteLine("Olá"); #endregion } } }

Saída: cinco linhas de "Olá".

Instruções Avançadas de Compilador com #pragma

• Permite controle fino sobre comportamento do compilador.
• Usos comuns:
  • #pragma warning disable — desliga todos os avisos.
  • #pragma warning restore — reabilita avisos.
  • Números de aviso específicos podem ser alvo (ex.: #pragma warning disable CS0168).
  • #pragma checksum — gera checksums para fins de depuração.

Exemplo

using System; namespace Diretiva { class PragmaDemo { public static void Main(string[] args) { #pragma warning disable #warning Este é um aviso 1 #pragma warning restore #warning Este é um aviso 2 } } }

Apenas o segundo aviso é exibido.

Para mais detalhes, consulte a referência oficial #pragma (referência C#).