字段与属性 C#（开发者用法）

什么是字段？

字段是直接在类或结构中声明的变量。 字段通常用于直接存储数据，使其简单，但在封装和控制方面存在风险。

public class DocumentSettings
{
    public string headerText; // 字段
}

public class DocumentSettings
{
    public string headerText; // 字段
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

字段速度快且轻量，但缺乏访问修饰符、setter方法或验证逻辑等保护。 这就是为什么应该谨慎使用它们——尤其当该值直接由外部代码访问时。

什么是属性？

C# 中的属性作为字段的受控接口。 它提供了一种灵活的方式来检索或分配属性值，同时允许其 get 或 set 访问器内的附加逻辑。

public class DocumentSettings
{
    public string HeaderText { get; set; } // 属性
}

public class DocumentSettings
{
    public string HeaderText { get; set; } // 属性
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

属性是公共数据访问的理想选择，因为它们提供了封装，并且可以轻松地与使用反射的框架集成，例如 IronPDF。

字段和属性之间的关键差异

特征

字段

属性

封装

无

是

支持逻辑

无t possible

通过 get/set 支持

反射友好

无t reliably

是

数据绑定

无t ideal

首选

简而言之：对于面向公共的数据使用属性，尤其是当您使用像 IronPDF 这样的依赖于反射或序列化的工具时。

示例：PDF 导出配置

// 字段: Might be ignored
public class PdfExportOptions
{
    public string footerHtml; // fields store data directly, but not safely
}
// 属性: Recognized and controlled
public class PdfExportOptions
{
    public string FooterHtml { get; set; } // easy to modify, validate, or hide
}

// 字段: Might be ignored
public class PdfExportOptions
{
    public string footerHtml; // fields store data directly, but not safely
}
// 属性: Recognized and controlled
public class PdfExportOptions
{
    public string FooterHtml { get; set; } // easy to modify, validate, or hide
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

在 IronPDF 中的序列化和数据绑定

IronPDF 的功能，如 HTML 模板、表单填充或元数据插入，都依赖于属性，因为它们可以通过反射访问。 如果您将数据传递给模板或导出表单：

• 字段s may be skipped entirely.
• 属性确保数据被正确地检索并在最终的文件中呈现。

这在处理复杂模型或用户生成数据时尤为重要。

将属性用于公共 API 交互

如果您的模型被 IronPDF（或任何外部库）使用，请使用带有适当访问修饰符的公共属性，以确保安全、可维护的访问。

public class InvoiceData
{
    public string CustomerName { get; set; }
    public DateTime InvoiceDate { get; set; }
}

public class InvoiceData
{
    public string CustomerName { get; set; }
    public DateTime InvoiceDate { get; set; }
}

Public Class InvoiceData
	Public Property CustomerName() As String
	Public Property InvoiceDate() As DateTime
End Class

这确保了 IronPDF（以及其他 .NET 库）可以通过反射和序列化访问这些值。

Keep 字段s Private and Internal

对于您不希望外部组件或库访问的数据，使用字段来处理内部逻辑。

public class InvoiceData
{
    private string internal无te; // 无t meant for IronPDF
}

public class InvoiceData
{
    private string internal无te; // 无t meant for IronPDF
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

这是保持逻辑干净、安全和可预测的好做法。

字段s: Less Secure, Less Controlled

字段s expose data directly, without any logic or guardrails. 当您声明一个公共字段时，您就对应用程序的任何位置甚至外部库开放了该值。

// 字段 – no protection
public class Person
{
    public string name;
}

// 字段 – no protection
public class Person
{
    public string name;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

在这种设置下：

• 任何人都可以读写作者值，没有限制。
• 您无法拦截更改以应用验证、日志记录或清理。
• 如果使用不当，像 IronPDF 这样的库可能会以意外的方式使用或覆盖此数据。

这种缺乏控制变成了潜在的安全风险，尤其是在处理用户输入、生成动态文档或通过边界（例如，通过 API、序列化或 Razor 模板）暴露内部对象时。

属性：更安全，更灵活

属性允许您通过 get 和 set 访问器控制对数据的访问。 您可以强制执行规则、验证输入并限制写访问——使它们更安全。

// 属性 – safer use of our Person class
public class Person
{
    private string _name;
    public string Name
    {
        get => _name;
        set
        {
            if (string.IsNullOrWhiteSpace(value))
                throw new ArgumentException("Name is required");
            _name = value.Trim();
        }
    }
}

// 属性 – safer use of our Person class
public class Person
{
    private string _name;
    public string Name
    {
        get => _name;
        set
        {
            if (string.IsNullOrWhiteSpace(value))
                throw new ArgumentException("Name is required");
            _name = value.Trim();
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

这种方法：

• 防止不良数据被存储。
• 为您提供记录访问或强制执行业务规则的挂钩。
• 保护应用程序的内部状态。
• 确保任何第三方库（如 IronPDF）可以安全、可预测地使用您的数据。

在敏感场景中——如生成包含用户元数据、发票或审计日志的官方 PDF——使用属性让您对对象的输入和输出拥有完全的控制。

为什么这对 IronPDF 来说很重要

IronPDF 不会内在地“违反”您的数据完整性，但在许多领域依赖于反射。 如果您将数据模型传入 Razor 模板、元数据字段或导出配置中：

• 您希望确保只暴露已清理、已验证的值。
• 您希望能够控制数据的读写方式。

使用属性可以让您控制这一流程，而公共字段则让您的应用程序更易受到意外行为的影响。

此代码的功能

• 创建了一个带有 已清理属性 的 PdfMetadata 类。
• 使用 ChromePdfRenderer 渲染一个基本的 HTML 模板。
• 将已清理的作者数据注入到HTML 内容和PDF 元数据中。
• 将最终输出保存到 SecureOutput.pdf。