字段（C# 编程指南）

项目
08/12/2011

更新：2010 年 8 月

“字段”是直接在类或结构中声明的任何类型的变量。字段是其包含类型的“成员”。

类或结构可以拥有实例字段或静态字段，或同时拥有两者。实例字段特定于类型的实例。如果您拥有类 T 和实例字段 F，可以创建类型 T 的两个对象，并修改每个对象中 F 的值，这不影响另一对象中的该值。相比之下，静态字段属于类本身，在该类的所有实例中共享。从实例 A 所做的更改将立刻呈现在实例 B 和 C 上（如果它们访问该字段）。

通常应仅为具有私有或受保护可访问性的变量使用字段。您的类向客户端代码公开的数据应通过方法、属性和索引器提供。通过使用这些构造间接访问内部字段，可以针对无效的输入值提供防护。存储由公共属性公开的数据的私有字段称为“后备存储”或“支持字段”。

字段通常存储这样的数据：该数据必须可供多个类方法访问，并且其存储期必须长于任何单个方法的生存期。例如，表示日历日期的类可能有三个整数字段：一个表示月份，一个表示日期，还有一个表示年份。不在单个方法范围外部使用的变量应在方法体自身范围内声明为局部变量。

在类块中通过指定字段的访问级别，然后指定字段的类型，再指定字段的名称来声明这些字段。例如：

public class CalendarEntry
{
    // private field
    private DateTime date;

    // public field (Generally not recommended.)
    public string day;

    // Public property exposes date field safely.
    public DateTime Date 
    {
        get 
        {
            return date;
        }
        set 
        {
            // Set some reasonable boundaries for likely birth dates.
            if (value.Year > 1900 && value.Year <= DateTime.Today.Year)
            {
                date = value;
            }
            else
                throw new ArgumentOutOfRangeException();
        }

    }

    // Public method also exposes date field safely.
    // Example call: birthday.SetDate("1975, 6, 30");
    public void SetDate(string dateString)
    {
        DateTime dt = Convert.ToDateTime(dateString);

        // Set some reasonable boundaries for likely birth dates.
        if (dt.Year > 1900 && dt.Year <= DateTime.Today.Year)
        {
            date = dt;
        }
        else
            throw new ArgumentOutOfRangeException();
    }

    public TimeSpan GetTimeSpan(string dateString)
    {
        DateTime dt = Convert.ToDateTime(dateString);

        if (dt != null && dt.Ticks < date.Ticks)
        {
            return date - dt;
        }
        else
            throw new ArgumentOutOfRangeException();  

    }
}

若要访问对象中的字段，请在对象名称后面添加一个句点，然后添加该字段的名称，比如 objectname.fieldname。例如：

CalendarEntry birthday = new CalendarEntry();
birthday.day = "Saturday";

声明字段时可以使用赋值运算符为字段指定一个初始值。例如，若要自动将 "Monday" 赋给 day 字段，需要声明 day，如下例所示：

public class CalendarDateWithInitialization
{
    public string day = "Monday";
    //...
}

字段的初始化紧靠调用对象实例的构造函数之前。如果构造函数为字段赋值，则该值将覆盖字段声明期间给出的任何值。有关更多信息，请参见使用构造函数（C# 编程指南）。

提示

字段初始值设定项不能引用其他实例字段。

字段可标记为 public、private、protected、internal 或 protected internal。这些访问修饰符定义类的使用者访问字段的方式。有关更多信息，请参见访问修饰符（C# 编程指南）。

可以选择将字段声明为 static。这使得调用方在任何时候都能使用字段，即使类没有任何实例。有关更多信息，请参见静态类和静态类成员（C# 编程指南）。

可以将字段声明为 readonly。只读字段只能在初始化期间或在构造函数中赋值。 static readonly 字段非常类似于常数，只不过 C# 编译器不能在编译时访问静态只读字段的值，而只能在运行时访问。有关更多信息，请参见常量（C# 编程指南）。

C# 语言规范

有关更多信息，请参见 C# 语言规范。C# 语言规范是 C# 语法和用法的权威资料。

请参见

参考

概念

C# 编程指南

修订记录

Date	修订记录	原因
2010 年 8 月	更正了示例中的 if 语句中的条件。	客户反馈

2010 年 8 月

更正了示例中的 if 语句中的条件。

客户反馈

通过

字段（C# 编程指南）

C# 语言规范

请参见

参考

概念

修订记录

其他资源