Entendiendo clases y métodos parciales en C#

Entendiendo clases y métodos parciales en C#

Este artículo explica cómo y por qué los desarrolladores de C# usan clases parciales y métodos parciales para gestionar grandes bases de código, colaborar eficazmente y optimizar la compilación.

Cuando múltiples desarrolladores trabajan en una sola clase extensa, o cuando necesitas fusionar código escrito a mano con código generado por herramientas como Visual Studio, la palabra clave partial de C# ofrece una solución limpia.

¿Qué es una clase parcial?

Una clase parcial te permite dividir la definición de una sola clase en dos o más archivos de origen. Cada archivo contiene un fragmento de la clase, y el compilador los une en tiempo de compilación. La palabra clave partial debe aparecer en cada parte de la clase.

Ejemplo 1 – Dividiendo una clase simple

Considera un proyecto llamado HeightWeightInfo que almacena la altura y peso de una persona.

namespace HeightWeightInfo {
    public partial class Record {
        private int h;
        private int w;
        public Record(int h, int w) {
            this.h = h;
            this.w = w;
        }
    }
}

La misma clase Record continúa en un segundo archivo.

namespace HeightWeightInfo {
    public partial class Record {
        public void PrintRecord() {
            Console.WriteLine("Height:" + h);
            Console.WriteLine("Weight:" + w);
        }
    }
}

Finalmente, el programa que usa la clase se ve así:

namespace HeightWeightInfo {
    class Program {
        static void Main(string[] args) {
            Record myRecord = new Record(10, 15);
            myRecord.PrintRecord();
            Console.ReadLine();
        }
    }
}

El compilador fusiona las dos definiciones de Record en una sola clase que contiene tanto el constructor como el método PrintRecord.

Cuándo usar clases parciales

1. Proyectos grandes con múltiples desarrolladores: Cada miembro del equipo puede editar un archivo separado sin conflictos.
2. Código generado automáticamente: Los IDEs a menudo crean archivos que no deben editarse manualmente; las clases parciales permiten añadir lógica personalizada sin modificar código generado.

Puntos clave a recordar

• La palabra clave partial debe aparecer en cada archivo que contribuye a la clase.
• Todas las partes deben residir en el mismo espacio de nombres y compilarse juntas.
• Todas las partes deben compartir el mismo modificador de acceso (p.ej., public, internal).
• Si alguna parte declara la clase como abstract o sealed, toda la clase hereda ese atributo.
• Todos los miembros definidos en cualquier parte son visibles para todas las demás partes.
• Los modificadores partial no están permitidos en delegados o enumeraciones.

¿Qué es un método parcial?

Un método parcial es un tipo especial de método que puede declararse en una parte de una clase parcial e implementarse opcionalmente en otra. Si se omite la implementación, tanto la declaración del método como cualquier llamada a él son descartadas en tiempo de compilación, lo que puede mejorar el rendimiento.

Ejemplo 2 – Usando métodos parciales

En file1.cs, la clase Car declara un método parcial y otros métodos regulares.

public partial class Car {
    partial void InitializeCar();
    public void BuildRim() { }
    public void BuildWheels() { }
}

En file2.cs, la misma clase Car proporciona la implementación para InitializeCar y añade otro método.

public partial class Car {
    public void BuildEngine() { }
    partial void InitializeCar() {
        string str = "Car";
    }
}

Las declaraciones de métodos parciales consisten en dos partes: la firma en un archivo y la implementación opcional en el mismo u otro archivo.

Reglas para métodos parciales

• Deben declararse con la palabra clave partial.
• El tipo de retorno siempre es void (sin valor de retorno).
• Son implícitamente private; no pueden ser public, protected o internal.
• No pueden declararse virtual, override o abstract.
• Si no se proporciona implementación, el compilador elimina el método y cualquier llamada a él.