IRONSOFTWAREHOME
开发者更新

C# Primary Constructor(开发者如何使用)

Jacob Mellor,Team Iron 的首席技术官
Jacob Mellor
Updated: 2026年9月4日

在 C# 编程的面向对象环境中,主构造函数的引入为语言带来了新的优雅和简洁。 主构造函数与拦截器和集合表达式等功能一起,在 C# 12 中作为一个强大的特性出现,为使用参数声明构造函数提供了更简洁的语法。 您可以在 微软 C# 指南上深入探索主构造函数。

在本文中,我们将学习如何高效使用 C# 12 主构造函数,同时探索其功能、用例以及它们如何改变开发人员设置类初始化的方式。

Understanding the Basics: Constructors in C#

构造函数在面向对象编程中起着至关重要的作用,是初始化对象的蓝图。 传统上,C# 开发人员使用默认构造函数或参数化构造函数来设置类的初始状态。 然而,主构造函数的引入为这个 C# 开发的重要方面提供了一种更精简的方法。

主构造函数的本质

在 C# 中,主构造函数是一种直接在类声明中声明和初始化属性的简洁方法。 它简化了定义和分配属性值的过程,提供了更具声明性和可读性的语法。

主构造函数的优势

  1. **简洁性:**主构造函数提供简洁的语法,减少样板代码并增强可读性。
  2. **作用域:**与传统构造函数不同的是,主构造函数中的参数在整个类或结构体中都处于作用域,使其使用更灵活。
  3. **默认值:**默认参数值简化了对象创建,对开发人员来说更加方便。

声明主构造函数

主构造函数的语法涉及在类头中直接声明属性。 让我们考虑一个基本的Person类示例:

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}";
}

在上面的代码片段中,Person 类具有一个主构造函数,该构造函数初始化了实例成员 Name 和实例成员 Age 属性。 构造函数参数以类名或结构体名声明,并在定义公共属性时,将参数值分配给它们。

示例 1:二维空间中的不可变点

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);
}

在此示例中,Point 结构体的主构造函数初始化 X 和 Y 属性,展示了语法如何简明而富有表现力。

示例 2:具有默认设置的可配置 Logger

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
    }
}

在此示例中,Logger 类的主构造函数为 filePath 和 level 提供了默认值,做到灵活易用,同时保持可配置性。

示例 3:依赖注入

public interface IService
{
    Distance GetDistance();
}

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

主构造函数适用于依赖注入场景。 在此示例中,控制器类表明其依赖关系,增强了可维护性,并促进了单元测试。

示例 4:构建几何形状层次结构

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);
}

在此示例中,Shape 类的主构造函数构成了几何形状层次结构的基础。 像 Rectangle 和 Circle 等子类利用主构造函数实现一致的初始化。 Rectangle 类本身声明了主构造函数,并将捕获的主构造函数参数传递给 Shape 类的主参数。 Circle 类通过在整个类内定义构造函数,然后使用 base 关键字将其参数作为默认值传递给 Shape 构造函数,展示了灵活性。

IronPDF 简介

IronPDF 是一个多功能的 C# 库,使开发人员能够轻松创建、操作和转换 PDF 文件。 无论是生成发票、报告还是其他文档,IronPDF 都允许您在 C# 应用程序中无缝地将 HTML 内容转换为优雅的专业 PDF。

IronPDF 是开发人员的一个方便工具,让他们把网页、URL 和 HTML 转换为 PDF。 最好的部分是,生成的 PDF 看起来和原始网页一模一样,所有的格式和样式都得以保留。 它非常适合从网页内容创建像报告和发票这样的 PDF。

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");
    }
}

C# 主构造函数(它如何为开发者工作):图1 - IronPDF网页

安装 IronPDF:快速入门

要将 IronPDF 纳入您的 C# 项目,请开始安装 IronPDF 的 NuGet 包。 或者,在NuGet包管理器中找到"IronPDF"并继续安装。

PM > Install-Package IronPdf

使用IronPDF创建PDF是一个简单的过程。

C# 主构造函数(它如何为开发者工作):图2 - 在NuGet包管理器浏览器中搜索IronPDF包

使用 IronPDF 生成 PDF

using IronPDF 创建 PDF 是一个简化的过程。 请考虑以下示例:

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");

请访问此 探索IronPDF代码示例 资源,获取更多创建PDF文档的方法。 有关 C# 中创建和操作 PDF 的更多详细信息,请访问这个完整的教程链接,并访问这个文档页面以探索更多。

C# 主构造函数:类初始化的革命

C# 主构造函数提供了一种声明性和简化的方法,直接在类声明中初始化类属性。 让我们探讨一下这个优雅的特性是否可以无缝集成到 IronPDF 中。

与 IronPDF 集成的 C# 主构造函数

虽然 C# 主构造函数主要是一个专注于类初始化的语言特性,但它们与 IronPDF 的直接集成可能不是一个常见的用例。 IronPDF 的核心功能在于 PDF 文档的生成和操作,类初始化的具体细节可能不直接与此工作流程对齐。

然而,开发人员可以在定义与 IronPDF 配置或数据模型相关的自定义类或结构体时运用 C# 主构造函数。 例如,如果您的应用程序需要特定的类结构来管理 PDF 相关的设置或配置,C# 主构造函数可以成为简洁初始化这些类的一个宝贵工具。

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");

在此示例中,PdfGenerationSettings 类利用 C# 主构造函数初始化与 PDF 生成设置相关的属性,这些属性可用于确定哪些渲染选项要添加、哪些要跳过。输出包含头文本和标题,因为它是使用主构造函数参数设置的。

C# 主构造函数(它如何为开发者工作):图3 - 上述代码示例的输出PDF

结论

总之,C# 中的主构造函数提供了一种精致的和富有表现力的类初始化方法。 它们的声明性语法增强了代码可读性,促进了不变性,并简化了创建带有默认值的对象的过程。 无论您是在定义属性、强制不变性、或者采用默认值,主构造函数赋予开发人员掌握 C# 编程动态世界中类初始化的艺术。

虽然 C# 主构造函数与 IronPDF 之间的直接集成可能不是重点,但这两个元素可以和谐工作。 C# 主构造函数提升了类初始化的清晰性和简洁性,使其在定义与 IronPDF 工作流程相关的结构或配置时具有价值。

利用 IronPDF 的强大功能进行稳健的 PDF 生成,并在类初始化优雅至关重要时运用 C# 主构造函数。 这种动态组合让您能够在 C# 编程的充满活力的世界中,以创造力和效率应对文档生成的复杂性。

IronPDF提供免费试用,其Lite许可证起价于$999。

Jacob Mellor,Team Iron 的首席技术官
首席技术官

Jacob Mellor 是 Iron Software 的首席技术官,也是一位开创 C# PDF 技术的有远见的工程师。作为 Iron Software 核心代码库的原始开发者,他从公司成立之初就开始塑造公司的产品架构,与首席执行官 Cameron Rimington 一起将公司转变为一家拥有 50 多名员工的公司,为 NASA、特斯拉和全球政府机构提供服务。

相关文章

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

OR
bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起