主要是作为个人笔记使用.具体可以参考官方文档和百度.
你可以定义自定义特性并将其放入源代码中这一事实,在没有检索该信息并对其进行操作的方法的情况下将没有任何价值。
通过使用反射,可以检索通过自定义特性定义的信息。主要方法是 GetCustomAttributes
,它返回对象数组,这些对象在运行时等效于源代码特性。此方法有多个重载版本。有关详细信息,请参阅 Attribute。
特性规范,例如:
C#
代码语言:javascript复制[Author("P. Ackerman", version = 1.1)]
class SampleClass
在概念上等效于此:
C#
代码语言:javascript复制Author anonymousAuthorObject = new Author("P. Ackerman");
anonymousAuthorObject.version = 1.1;
但是,在为特性查询 SampleClass
之前,代码将不会执行。对 SampleClass
调用 GetCustomAttributes
会导致按上述方式构造并初始化一个 Author
对象。如果该类具有其他特性,则将以类似方式构造其他特性对象。
然后 GetCustomAttributes
会以数组形式返回 Author
对象和任何其他特性对象。之后你便可以循环访问此数组,根据每个数组元素的类型确定所应用的特性,并从特性对象中提取信息。
示例
此处是一个完整的示例。定义自定义特性、将其应用于多个实体,并通过反射对其进行检索。
C#
代码语言:javascript复制// Multiuse attribute.
[System.AttributeUsage(System.AttributeTargets.Class |
System.AttributeTargets.Struct,
AllowMultiple = true) // Multiuse attribute.
]
public class Author : System.Attribute
{
string name;
public double version;
public Author(string name)
{
this.name = name;
// Default value.
version = 1.0;
}
public string GetName()
{
return name;
}
}
// Class with the Author attribute.
[Author("P. Ackerman")]
public class FirstClass
{
// ...
}
// Class without the Author attribute.
public class SecondClass
{
// ...
}
// Class with multiple Author attributes.
[Author("P. Ackerman"), Author("R. Koch", version = 2.0)]
public class ThirdClass
{
// ...
}
class TestAuthorAttribute
{
static void Test()
{
PrintAuthorInfo(typeof(FirstClass));
PrintAuthorInfo(typeof(SecondClass));
PrintAuthorInfo(typeof(ThirdClass));
}
private static void PrintAuthorInfo(System.Type t)
{
System.Console.WriteLine("Author information for {0}", t);
// Using reflection.
System.Attribute[] attrs = System.Attribute.GetCustomAttributes(t); // Reflection.
// Displaying output.
foreach (System.Attribute attr in attrs)
{
if (attr is Author a)
{
//Author a = (Author)attr;
System.Console.WriteLine(" {0}, version {1:f}", a.GetName(), a.version);
}
}
}
}
/* Output:
Author information for FirstClass
P. Ackerman, version 1.00
Author information for SecondClass
Author information for ThirdClass
R. Koch, version 2.00
P. Ackerman, version 1.00
*/
特性具有以下属性:
- 特性向程序添加元数据。 元数据是程序中定义的类型的相关信息。所有 .NET 程序集都包含一组指定的元数据,用于描述程序集中定义的类型和类型成员。可以添加自定义特性来指定所需的其他任何信息。有关详细信息,请参阅创建自定义特性 (C#)。
- 可以将一个或多个特性应用于整个程序集、模块或较小的程序元素(如类和属性)。
- 特性可以像方法和属性一样接受自变量。
- 程序可使用反射来检查自己的元数据或其他程序中的元数据。有关详细信息,请参阅使用反射访问特性 (C#)。