C# AttributeUsage的使用浅析

 

attributeusage

C# attributeusage的使用是如何的呢?首先让我们来了解一下什么是AttributeUsage类它是另外一个预定义特性类,AttributeUsage类的作用就是帮助我们控制定制特性的使用。其实AttributeUsage类就是描述了一个定制特性如和被使用。

C# AttributeUsage的使用要明白:

AttributeUsage有三个属性,我们可以把它放置在定制属性前面。第一个属性是:

validOn

通过这个属性,我们能够定义定制特性应该在何种程序实体前放置。一个属性可以被放置的所有程序实体在AttributeTargets enumerator中列出。通过OR操作我们可以把若干个AttributeTargets值组合起来。

◆AllowMultiple

这个属性标记了我们的定制特性能否被重复放置在同一个程序实体前多次。

◆Inherited

我们可以使用这个属性来控制定制特性的继承规则。它标记了我们的特性能否被继承。

C# AttributeUsage的使用实例:

下面让我们来做一些实际的东西。我们将会在刚才的Help特性前放置AttributeUsage特性以期待在它的帮助下控制Help特性的使用。

using System;    [AttributeUsage(AttributeTargets.Class), AllowMultiple = false, Inherited = false ]    public class HelpAttribute : Attribute    {        public HelpAttribute(String Description_in)     {            this.description = Description_in;        }         protected String description;         public String Description {            get {                return this.description;            }        }  }

先让我们来看一下AttributeTargets.Class。它规定了Help特性只能被放在class的前面。这也就意味着下面的代码将会产生错误:

[Help("this is a do-nothing class")]    public class AnyClass    {        [Help("this is a do-nothing method")] //ERROR        public void AnyMethod()     {        }    } 

编译器报告错误如下:

AnyClass.cs: Attribute ‘Help’ is not valid on this declaration type.

It is valid on ‘class’ declarations only.

我们可以使用AttributeTargets.All来允许Help特性被放置在任何程序实体前。可能的值是:

   Assembly,      Module,      Class,      struct,      Enum,      constructor,      Method,      Property,      field,      Event,      Interface,      parameter,      Delegate,      All = Assembly | Module | Class |      Struct | Enum | Constructor |      Method | Property | Field | Event |      Interface | Parameter | Delegate,      ClassMembers = Class | Struct | Enum |      Constructor | Method | Property | Field |      Event | Delegate | Interface ) 

下面考虑一下AllowMultiple = false。它规定了特性不能被重复放置多次。

[Help("this is a do-nothing class")]    [Help("it contains a do-nothing method")]    public class AnyClass    {        [Help("this is a do-nothing method")] //error        public void AnyMethod()     {        }  }  

它产生了一个编译期错误。

AnyClass.cs: Duplicate ‘Help’ attribute

Ok,现在我们来讨论一下最后的这个属性。Inherited, 表明当特性被放置在一个基类上时,它能否被派生类所继承。

[Help("BaseClass")]    public class Base    {    }          public class Derive : Base    {    } 

C# AttributeUsage的使用会有四种可能的组合:

[AttributeUsage(AttributeTargets.Class,   AllowMultiple = false, Inherited = false ]    [AttributeUsage(AttributeTargets.Class,    AllowMultiple = true, Inherited = false ]    [AttributeUsage(AttributeTargets.Class,    AllowMultiple = false, Inherited = true ]    [AttributeUsage(AttributeTargets.Class,    AllowMultiple = true, Inherited = true ] 

C# AttributeUsage的使用第一种情况:

如果我们查询(Query)(稍后我们会看到如何在运行期查询一个类的特性)Derive类,我们将会发现Help特性并不存在,因为inherited属性被设置为false。

C# AttributeUsage的使用第二种情况:

和第一种情况相同,因为inherited也被设置为false。

C# AttributeUsage的使用第三种情况:

为了解释第三种和第四种情况,我们先来给派生类添加点代码:

[Help("BaseClass")]    public class Base    {    }    [Help("DeriveClass")]    public class Derive : Base    {    } 

现在我们来查询一下Help特性,我们只能得到派生类的属性,因为inherited被设置为true,但是AllowMultiple却被设置为false。因此基类的Help特性被派生类Help特性覆盖了。

C# AttributeUsage的使用第四种情况:

在这里,我们将会发现派生类既有基类的Help特性,也有自己的Help特性,因为AllowMultiple被设置为true。

C# AttributeUsage的相关内容就向你介绍到这里,希望对你了解和掌握C# AttributeUsage的使用有所帮助。

相关阅读

【C#学习笔记】读access2007

using System; using System.Data.OleDb; namespace ConsoleApplication { class Program { static void Main(

C#如何使用log4net记录本地日志

第一步:首先从Visual Studio中的Nuget包管理中搜索下载 Log4Net dll文件 如下图: 第二步:打开配置文件 WinFrom就是 App.config We

C#中ref和out关键字的应用以及区别。

C#中ref和out关键字的应用以及区别。refref的定义ref 的使用outout的定义:来自MSDNout的用法ref和out的区别Stack Overflow的解释:

C# DateTime.Compare时间大小对比

转载于:https://www.cnblogs.com/lbonet/p/10215723.html

c#KeyValuePair初始化

KeyValuePair初始化 在小括号不在大括号,记一下以免以后忘了

发表评论