快捷導(dǎo)航

C# 特性AttributeUsage簡介與使用教程

更新時(shí)間：2023年05月27日 14:56:44 作者：wu.g.q

這篇文章主要介紹了C# 特性AttributeUsage簡介與使用教程,本文通過示例代碼給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下

AttributeUsage

預(yù)定義特性AttributeUsage描述了如何使用一個(gè)自定義特性類。它規(guī)定了特性可應(yīng)用到的項(xiàng)目的類型。

規(guī)定該特性的語法如下：

[AttributeUsage(
? ?validon,
? ?AllowMultiple=allowmultiple,
? ?Inherited=inherited
)]

validon：自定義特性的對象，可以是類、方法、屬性等對象（默認(rèn)值是 AttributeTargets.All）
AllowMultiple：是否允許被多次使用（默認(rèn)值為false：單用的）
Inherited：是否可被派生類繼承（默認(rèn)值為false：不能）

下面請看使用：

using System;
namespace AttributeUsagePractice
{
    [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; }
        }
    }
    class Program
    {
        [Help("this is a main class")]　　//error
        public static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
            // TODO: Implement Functionality Here
            Console.Write("Press any key to continue . . . ");
            Console.ReadKey(true);
        }
    }
}

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

含義為：定制特性類，不允許多次使用，不能被繼承

第一個(gè)參數(shù)：
因?yàn)樗奶匦阅繕?biāo)是 AttributeTargets.Class，而它放在函數(shù)前面，所以上面的程序會(huì)報(bào)錯(cuò)：特性“Help”對此聲明類型無效。它只對“class”聲明有效，正確的做法是放在 class Program 上面。

如果是下面的代碼：

using System;
namespace AttributeUsagePractice
{
    [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; }
        }
    }
    [Help("this is a main class")]
    [Help("this is a main2 class")]　　//error
    class Program
    {
        public static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
            // TODO: Implement Functionality Here
            Console.Write("Press any key to continue . . . ");
            Console.ReadKey(true);
        }
    }
}

第二個(gè)參數(shù)：

因?yàn)锳llowMultiple = false，上面多次使用，所以報(bào)錯(cuò) 重復(fù)的“Help”特性，正確的做法就是去掉它

using System;
using System.Linq;
namespace AttributeUsagePractice
{
    [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false)]
    public class HelpAttribute : Attribute
    {
        public HelpAttribute(){}
        public HelpAttribute(String Description_in)
        {
            this.description = Description_in;
        }
        protected String description;
        public String Description
        {
            get { return this.description; }
        }
    }
    [Help("this is a HelpAttribute use class")]
    public class UseHelpAttribute
    {
    }
    public class UseHelpAttributeDerive : UseHelpAttribute
    {
    }
    class Program
    {
        public static void Main(string[] args)
        {
            // TODO: Implement Functionality Here
            UseHelpAttributeDerive objHelpAttribute = new UseHelpAttributeDerive();
            Type t = objHelpAttribute.GetType();
            object [] objAttrs = t.GetCustomAttributes(typeof(HelpAttribute),true);
            if(objAttrs!= null && objAttrs.Length > 0)
            {
                object temp = objAttrs.First();
                HelpAttribute myAttr = temp as HelpAttribute;
                Console.WriteLine("類描述：{0}", myAttr.Description);
            }
            else
            {
                Console.WriteLine("沒有類描述");
            }
            Console.ReadKey(true);
        }
    }
}

第三個(gè)參數(shù)：

因?yàn)镮nherited = false，所以運(yùn)行結(jié)果為;