Dominando las Directivas de Preprocesador en C#: Guía Práctica

Dominando las Directivas de Preprocesador en C#

Descubre cómo las directivas de preprocesador en C# moldean la compilación, controlan el flujo y manejan errores. Esta guía cubre cada directiva, su sintaxis, ejemplos reales y mejores prácticas.

Las directivas de preprocesador son comandos que el compilador evalúa antes de que comience la compilación real. Dictan qué secciones de código se incluyen, cómo se manejan advertencias y errores, e incluso pueden modificar la visión del compilador sobre números de línea y nombres de archivo.

En C#, una directiva comienza con el símbolo # y abarca una sola línea, terminada por un salto de línea en lugar de un punto y coma.

#if expresión 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 Tu mensaje de advertencia

#error Tu mensaje de error

#line 50 "ArchivoFalso.cs" #endif

#region Descripción código #endregion

#pragma warning disable #endif

Definiendo y Eliminando Símbolos

• #define crea un símbolo que evalúa a true en bloques #if.
• #undef elimina un símbolo, haciéndolo evaluar a false.

Ejemplo: Definiendo un Símbolo

#define PRUEBAS

Ejemplo: Eliminando un Símbolo

#undef PRUEBAS

Compilación Condicional con #if, #elif, #else y #endif

• #if prueba una expresión; el código dentro se compila solo si la expresión es verdadera.
• Las expresiones pueden usar operadores lógicos (&&, ||, !) y símbolos.
• #elif permite probar múltiples condiciones secuencialmente.
• #else se ejecuta cuando ninguna de las condiciones previas se cumple.
• #endif termina el bloque condicional.

Ejemplo Práctico

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

Salida: CSHARP está definido, PYTHON no está definido

Generando Advertencias y Errores

• #warning emite una advertencia de compilador definida por el usuario pero permite que el programa continúe.
• #error emite un error fatal, deteniendo la compilación.

Ejemplo de Advertencia

using System; namespace Directivas { class DirectivaAdvertencia { public static void Main(string[] args) { #if (!CSHARP) #warning CSHARP no está definido #endif Console.WriteLine("Ejemplo de directiva #warning"); } } }

La salida incluye una línea de advertencia pero se imprime el texto de la consola.

Ejemplo de Error

using System; namespace Directiva { class Error { public static void Main(string[] args) { #if (!CSHARP) #error CSHARP no está definido #endif Console.WriteLine("Ejemplo de directiva #error"); } } }

Salida: la compilación falla con un error en tiempo de compilación; la última línea de consola nunca se ejecuta.

Personalizando Ubicaciones de Diagnóstico con #line

• Cambia el número de línea y nombre de archivo reportados para advertencias o errores subsiguientes.

Ejemplo

using System; namespace Directiva { class DemoLine { public static void Main(string[] args) { #line 200 "OtroPrograma.cs" #warning Advertencia real generada por Program.cs en la línea 10 } } }

Resultado: La advertencia aparece como OtroPrograma.cs(200,22): warning CS1030: ...

Organizando Código con #region y #endregion

• Agrupa bloques de código relacionados, que pueden colapsarse en editores.
• No pueden solaparse con otro #region, pero pueden residir dentro de un bloque condicional.

Ejemplo

using System; namespace Directiva { class DemoRegion { public static void Main(string[] args) { #region Hola Console.WriteLine("Hola"); Console.WriteLine("Hola"); Console.WriteLine("Hola"); Console.WriteLine("Hola"); Console.WriteLine("Hola"); #endregion } } }

Salida: cinco líneas de "Hola".

Instrucciones Avanzadas del Compilador con #pragma

• Permite control fino sobre el comportamiento del compilador.
• Usos comunes:
  • #pragma warning disable – desactiva todas las advertencias.
  • #pragma warning restore – reactiva las advertencias.
  • Números de advertencia específicos pueden ser objetivo (p. ej., #pragma warning disable CS0168).
  • #pragma checksum – genera sumas de verificación para depuración.

Ejemplo

using System; namespace Directiva { class DemoPragma { public static void Main(string[] args) { #pragma warning disable #warning Esta es una advertencia 1 #pragma warning restore #warning Esta es una advertencia 2 } } }

Solo se muestra la segunda advertencia.

Para más detalles, consulta la referencia oficial #pragma (referencia de C#).