在C#中,AttributeUsage
是一个元数据特性,它用于指定自定义属性可以如何应用于代码元素(如类、方法、属性等)。AttributeUsage
特性定义了属性的使用约束,以确保它们在代码中以正确的方式应用。
AttributeUsage
特性有两个主要的属性:
-
AttributeTargets
:这是一个枚举类型,表示属性可以应用于哪些代码元素。例如,你可以将其设置为AttributeTargets.Class
、AttributeTargets.Method
或AttributeTargets.Property
,以限制属性仅适用于类、方法或属性。 -
AllowMultiple
:这是一个布尔值,表示属性是否可以多次应用于同一个代码元素。如果将其设置为true
,则属性可以多次应用于同一个元素;如果将其设置为false
,则属性只能应用于每个元素一次。
以下是一个使用AttributeUsage
特性的示例:
using System;
[AttributeUsage(AttributeTargets.Method, AllowMultiple = false)]
public class MyCustomAttribute : Attribute
{
public string MyProperty { get; set; }
public MyCustomAttribute(string myProperty)
{
MyProperty = myProperty;
}
}
public class MyClass
{
[MyCustom("Hello, World!")]
public void MyMethod()
{
Console.WriteLine("My method is decorated with MyCustomAttribute.");
}
}
在这个示例中,我们定义了一个名为MyCustomAttribute
的自定义属性,并使用AttributeUsage
特性限制它只能应用于方法,并且只能应用一次。然后,我们将此属性应用于MyClass
类中的MyMethod
方法。