C# 8.0 编程

第 14 章 属性 属性

本作品已使用人工智能进行翻译。欢迎您提供反馈和意见：[e-mail]

在 .NET 中，您可以用属性来注解组件、类型及其成员。属性的作用是控制或修改框架、工具、编译器或 CLR 的行为。例如，在第 1 章中，我展示了一个使用[TestClass] 属性注释的类。这就告诉了单元测试框架，被注解的类包含了一些要作为测试套件的一部分运行的测试。

属性是信息的被动容器，本身不起任何作用。打个比方，在物理世界中，如果你打印出一张包含目的地和跟踪信息的运输标签，并把它贴在包裹上，那么这张标签本身并不会使包裹到达目的地。只有当包裹到了运输公司手中，这种标签才会发挥作用。当运输公司取走你的包裹时，就会发现标签的存在，并以此来确定包裹的运输路线。因此，标签很重要，但归根结底，它的唯一作用是提供一些系统需要的信息。.NET 属性的工作方式与此相同--只有当某些东西去寻找它们时，它们才会产生作用。有些属性由 CLR 或编译器处理，但这只是少数。大多数属性由框架、库、工具（如单元测试运行程序）或您自己的代码消耗。

应用属性

为了避免在类型系统中引入额外的概念集，.NET 将属性作为 .NET 类型的实例进行建模。要用作属性，类型必须派生自System.Attribute 类，但也可以是完全普通的类型。要应用属性，需要将类型的名称放在方括号中，通常直接放在属性目标的前面。例 14-1展示了微软测试框架中的一些属性。我在类上应用了一个属性，以表明该类包含我想运行的测试，我还在单个方法上应用了属性，告诉测试框架哪些方法代表测试，哪些方法包含在每个测试前运行的初始化代码。

例 14-1. 单元测试类中的属性

using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace ImageManagement.Tests
{
    [TestClass]
    public class WhenPropertiesRetrieved
    {
        private ImageMetadataReader _reader;

        [TestInitialize]
        public void Initialize()
        {
            _reader = new ImageMetadataReader(TestFiles.GetImage());
        }

        [TestMethod]
        public void ReportsCameraMaker()
        {
            Assert.AreEqual(_reader.CameraManufacturer, "Fabrikam");
        }

        [TestMethod]
        public void ReportsCameraModel()
        {
            Assert.AreEqual(_reader.CameraModel, "Fabrikam F450D");
        }
    }
}

如果您查看大多数属性的文档，您会发现它们的真实名称都以Attribute 结尾。如果没有您在括号中指定名称的类，C# 编译器会尝试追加Attribute ，因此例 14-1中的[TestClass] 属性指的是TestClassAttribute 类。如果确实需要，也可以将类名全拼出来，例如[TestClassAttribute]，但更常见的是使用较短的版本。

如果要应用多个属性，有两种选择。您可以提供多组括号，或者将多个属性放在一对括号内，中间用逗号隔开。

某些属性类型可以使用构造函数参数。例如，微软的测试框架包含一个 ...