Tipos y archivos parciales
Divida un tipo entre varios archivos con clases/structs parciales y use métodos parciales para enlazar lógica personalizada con código generado.
Tipos y archivos parciales es una lección gratuita de C# Academy en CoddyKit. Esta es la lección 3 de 3. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de C# Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de C# Academy incluye 3 lecciones en total.
Descripción general de los tipos partial
Objetivo: Divida tipos grandes de forma ordenada.
- partial class/struct: mismo espacio de nombres y nombre
- Normalmente se distribuyen en varios archivos
- partial methods: puntos de extensión opcionales dentro de tipos partial
Partes de una partial class
Una partial class puede declararse en varias partes. El compilador las combina en un solo tipo.
using System;
namespace Demo
{
// Part 1: data
public partial class Person
{
public string Name { get; private set; }
public Person(string name) { Name = name; }
}
// Part 2: behavior
public partial class Person
{
public string Greet() { return "Hi " + Name; }
}
}
public class Program
{
public static void Main(string[] args)
{
Demo.Person p = new Demo.Person("Ada");
Console.WriteLine(p.Greet());
}
}
Partial methods
Los partial methods son puntos de extensión en tiempo de compilación: si no se implementan, se elimina la llamada. En C# 6 deben ser void y privados.
using System;
namespace Demo
{
public partial class Processor
{
// Partial method: implicitly private, must return void in C# 6
partial void OnProcessed(string item);
public void Run(string item)
{
// do work...
OnProcessed(item); // call hook (removed by compiler if not implemented)
}
}
public partial class Processor
{
// Implementation lives in another part (often another file)
partial void OnProcessed(string item)
{
Console.WriteLine("Processed: " + item);
}
}
}
public class Program
{
public static void Main(string[] args)
{
Demo.Processor p = new Demo.Processor();
p.Run("report");
}
}
Cuándo usar partial
Casos de uso:
- Código de diseñador o generado en un archivo; sus ediciones seguras en otro.
- Tipos grandes divididos por funcionalidad: datos frente a comportamiento.
- Puntos de extensión opcionales mediante partial methods.
Partial struct
También puede dividir los tipos struct usando partial; el resultado es un único tipo struct en tiempo de compilación.
using System;
namespace Demo
{
public partial struct Pair
{
public int A;
}
public partial struct Pair
{
public int B;
public int Sum() { return A + B; }
}
}
public class Program
{
public static void Main(string[] args)
{
Demo.Pair p = new Demo.Pair();
p.A = 2; p.B = 3;
Console.WriteLine("Sum = " + p.Sum());
}
}
Reglas y consejos para partial
Consejos:
- Todas las partes deben usar el mismo espacio de nombres, nombre y modificador de acceso.
- Mantenga cada archivo centrado en una función (generado frente a manual).
- En C# 6, los métodos partial son void y privados; manténgalos pequeños.
Finalidad de una partial class
Resumen
Resumen: Use partial para dividir tipos entre varios archivos y añadir partial methods como puntos de extensión opcionales. Mantenga las partes en el mismo espacio de nombres y con el mismo nombre, y deje que el compilador las combine.
Preguntas frecuentes
¿La lección «Tipos y archivos parciales» es gratis?
Sí — el texto completo de «Tipos y archivos parciales» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de C# Academy, actualiza a CoddyKit PRO. El curso de C# Academy incluye 3 lecciones en total.
¿Qué aprenderé en «Tipos y archivos parciales»?
Divida un tipo entre varios archivos con clases/structs parciales y use métodos parciales para enlazar lógica personalizada con código generado. Practicas C# Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar C# Academy?
No se requiere experiencia previa. C# Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 3.
¿Cuánto tiempo toma la lección «Tipos y archivos parciales»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de C# Academy?
Sí. Cada lección de C# Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- public/internal/protected/private (con una nota sobre file)
- Namespaces, directivas using y global usings (nota)
- Tipos y archivos parciales