IRONSOFTWAREHOME
ACTUALIZACIONES PARA DESARROLLADORES

Constructor principal C# (Cómo funciona para desarrolladores)

Jacob Mellor, Director de Tecnología @ Team Iron
Jacob Mellor
Updated: 4 de septiembre de 2026

En el paisaje orientado a objetos de la programación C#, la introducción de Constructores Primarios trae un nuevo nivel de elegancia y simplicidad al lenguaje. Los constructores primarios, junto a características como interceptores y expresiones de colección, surgieron en C# 12 como una poderosa característica, ofreciendo una sintaxis más concisa para declarar constructores con parámetros. Puedes explorar en profundidad los constructores primarios en la guía de Microsoft C#.

En este artículo, aprenderemos cómo usar los Constructores Primarios de C# 12 de manera eficiente, explorando también su funcionalidad, casos de uso y cómo transforman la forma en que los desarrolladores abordan la inicialización de clases.

Understanding the Basics: Constructors in C#

Los constructores juegan un papel fundamental en la programación orientada a objetos, sirviendo como el plano para inicializar objetos. Tradicionalmente, los desarrolladores de C# han usado el constructor por defecto o constructores con parámetros para configurar el estado inicial de sus clases. Sin embargo, la introducción de Constructores Primarios añade un enfoque más simplificado a este aspecto esencial del desarrollo en C#.

La esencia de los constructores primarios

Un Constructor Primario en C# es una forma concisa de declarar e inicializar propiedades directamente dentro de la declaración de la clase. Simplifica el proceso de definir y asignar valores a las propiedades, ofreciendo una sintaxis más declarativa y legible.

Beneficios de los constructores primarios

  1. Concisión: Los constructores primarios proporcionan una sintaxis sucinta, reduciendo código repetitivo y mejorando la legibilidad.
  2. Alcance: A diferencia de los constructores tradicionales, los parámetros en los constructores primarios están en alcance a lo largo de toda la clase o estructura, ofreciendo flexibilidad en su uso.
  3. Valores Predeterminados: Los valores predeterminados de los parámetros simplifican la creación de objetos, haciéndolo más conveniente para los desarrolladores.

Declaración de un constructor primario

La sintaxis para un Constructor Primario implica declarar las propiedades directamente en el encabezado de la clase. Consideremos un ejemplo de clase Person básico:

public class Person(string name, int age)
{
    public string Name { get; } = name;
    public int Age { get; } = age;
    public override string ToString() => $"Name: {Name}, Age: {Age}";
}

En el fragmento de código anterior, la clase Person tiene un Constructor Primario que inicializa las propiedades de miembro de instancia Name y Age. Los parámetros del constructor se declaran con el nombre de la clase o estructura, y al momento de definir propiedades públicas, los valores de los parámetros se les asignan.

Ejemplo 1: Punto inmutable en un espacio 2D

public readonly struct Point(double x, double y)
{
    public double X { get; } = x;
    public double Y { get; } = y;
    public double Magnitude => Math.Sqrt(X * X + Y * Y);
}

En este ejemplo, el constructor primario para la estructura Point inicializa las propiedades X y Y, mostrando cuán concisa y expresiva puede ser la sintaxis.

Ejemplo 2: Registrador configurable con ajustes predeterminados

public class Logger(string filePath = "log.txt", LogLevel level = LogLevel.Info)
{
    private readonly string _filePath = filePath;
    private readonly LogLevel _level = level;

    public void Log(string message)
    {
        // Actual logging implementation using _filePath and _level
    }
}

Aquí, el constructor primario para la clase Logger proporciona valores predeterminados para filePath y level, haciéndolo flexible y fácil de usar mientras se mantiene la configurabilidad.

Ejemplo 3: Inyección de dependencias

public interface IService
{
    Distance GetDistance();
}

public class ExampleController(IService service) : ControllerBase
{
    public ActionResult<Distance> Get() => service.GetDistance();
}

Los constructores primarios son ideales para escenarios de inyección de dependencias. En este ejemplo, una clase controlador indica sus dependencias, mejorando el mantenimiento y facilitando las pruebas unitarias.

Ejemplo 4: Construcción de una jerarquía de formas geométricas

public abstract class Shape(double width, double height)
{
    public double Width { get; } = width;
    public double Height { get; } = height;
    public abstract double CalculateArea();
}

public class Rectangle(double width, double height) : Shape(width, height)
{
    public override double CalculateArea() => Width * Height;
}

public class Circle : Shape
{
    public Circle(double radius) : base(radius * 2, radius * 2) { }
    public override double CalculateArea() => Math.PI * Math.Pow(Width / 2, 2);
}

En este ejemplo, el constructor primario en la clase Shape forma la base para una jerarquía de formas geométricas. Subclases como Rectangle y Circle aprovechan el constructor primario para una inicialización consistente. La clase Rectangle declara el constructor primario y pasa los parámetros del constructor primario capturados a los parámetros primarios de la clase Shape. La clase Circle muestra flexibilidad al definir su constructor dentro de toda la clase y luego pasar sus parámetros como valores predeterminados para el constructor de Shape usando la palabra clave base.

Presentando IronPDF

IronPDF es una biblioteca versátil de C# que permite a los desarrolladores crear, manipular y convertir archivos PDF sin esfuerzo. Ya sea que estés generando facturas, informes u otro documento, IronPDF te permite convertir contenido HTML en PDFs profesionales y pulidos directamente en tu aplicación C#.

IronPDF es una herramienta útil para los desarrolladores que les permite convertir páginas web, URLs y HTML a PDF. La mejor parte es que los PDFs lucen igual que las páginas web originales, preservando todo el formato y estilo. Es perfecto para crear PDFs a partir de contenido web como informes y facturas.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Constructor primario de C# (Cómo funciona para el desarrollador): Figura 1 - Página web de IronPDF

Instalación de IronPDF: Un comienzo rápido

Ejecuta el siguiente comando en tu Consola del Administrador de Paquetes: Alternativamente, busca 'IronPDF' en NuGet y procede con la instalación.

PM > Install-Package IronPdf

Crear un PDF usando IronPDF es un proceso sencillo.

Constructor primario de C# (Cómo funciona para el desarrollador): Figura 2 - Buscando el paquete IronPDF en el navegador del administrador de paquetes NuGet

Generación de PDF con IronPDF

Crear un PDF usando IronPDF es un proceso simplificado. Considera el siguiente ejemplo:

var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");

Visita este recurso Explora Ejemplos de Código de IronPDF para más métodos de crear documentos PDF. Para más detalles sobre la creación y manipulación de PDFs en C#, por favor visita este completo enlace de tutorial, y para explorar más, por favor visita esta página de documentación.

Constructores Primarios de C#: Una Revolución en la Inicialización de Clases

Los constructores primarios de C# ofrecen un enfoque declarativo y simplificado para inicializar propiedades de clase directamente dentro de la declaración de la clase. Exploremos si esta elegante característica puede integrarse sin problemas con IronPDF.

Integración de los Constructores Primarios de C# con IronPDF

Mientras que los Constructores Primarios de C# son principalmente una característica del lenguaje enfocada en la inicialización de clases, su integración directa con IronPDF puede no ser un caso de uso común. La funcionalidad central de IronPDF radica en la generación y manipulación de documentos PDF, y los detalles de la inicialización de clases podrían no alinearse directamente con este flujo de trabajo.

Sin embargo, los desarrolladores pueden utilizar Constructores Primarios de C# al definir clases o estructuras personalizadas relacionadas con configuraciones o modelos de datos de IronPDF. Por ejemplo, si tu aplicación requiere una estructura de clase específica para gestionar configuraciones o ajustes relacionados con PDFs, los Constructores Primarios de C# pueden ser una herramienta valiosa para inicializar estas clases concisamente.

public class PdfGenerationSettings(string title, bool includeHeader, bool includeFooter)
{
    public string Title { get; } = title;
    public bool IncludeHeader { get; } = includeHeader;
    public bool IncludeFooter { get; } = includeFooter;
    // Additional properties...
}

// Usage with IronPDF
var pdfSettings = new PdfGenerationSettings("My PDF Title", true, false);
var renderOptions = new ChromePdfRenderOptions
{
    PaperSize = IronPdf.Rendering.PdfPaperSize.A4,
    MarginTop = 20,
    MarginBottom = 20,
    MarginLeft = 10,
    MarginRight = 10,
    Title = pdfSettings.Title
};
// Apply settings from PdfGenerationSettings
if (pdfSettings.IncludeHeader)
{
    renderOptions.TextHeader = new TextHeaderFooter
    {
        CenterText = "Page {page} of {total-pages}",
        DrawDividerLine = true
    };
}
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = renderOptions;
pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomizedDocument.pdf");

En este ejemplo, la clase PdfGenerationSettings utiliza un Constructor Primario de C# para inicializar propiedades relacionadas con configuraciones de generación de PDF, las cuales se pueden usar posteriormente para determinar qué opciones de renderización agregar y cuáles omitir. La salida contiene un texto de encabezado y título tal como fue establecido usando el parámetro del constructor primario.

Constructor primario de C# (Cómo funciona para el desarrollador): Figura 3 - PDF de salida del ejemplo de código anterior

Conclusión

En conclusión, los Constructores Primarios en C# presentan un enfoque refinado y expresivo para la inicialización de clases. Su sintaxis declarativa mejora la legibilidad del código, promueve la inmutabilidad y simplifica el proceso de crear objetos con valores predeterminados. Ya sea que estés definiendo propiedades, haciendo cumplir la inmutabilidad o adoptando valores predeterminados, los Constructores Primarios empoderan a los desarrolladores para dominar el arte de la inicialización de clases en el mundo dinámico de la programación en C#.

Mientras que la integración directa de Constructores Primarios de C# con IronPDF podría no ser el enfoque principal, estos dos elementos pueden trabajar armoniosamente. Los Constructores Primarios de C# mejoran la claridad y simplicidad de la inicialización de clases, haciéndolos valiosos para definir estructuras o configuraciones relacionadas con los flujos de trabajo de IronPDF.

Aprovecha la potencia de IronPDF para una generación robusta de PDFs, y emplea Constructores Primarios de C# donde la elegancia en la inicialización de clases sea primordial. Este dúo dinámico te permite navegar las complejidades de la generación de documentos con creatividad y eficiencia en el vibrante mundo de la programación en C#.

IronPDF ofrece una prueba gratuita y su licencia lite comienza desde $999.

Jacob Mellor, Director de Tecnología @ Team Iron
Director de Tecnología

Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.

...
Leer más

Artículos Relacionados

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

OR
bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999