C# 特性 简而易懂的笔记

今天差不多又花了一天时间来学习C# 的特性，本人主要是在菜鸟教程里学习，但是呢，菜鸟教程的笔记写得很笼统，看得不是很明白，于是乎，又在到处问度娘，看了许多篇别人写的博客，再结合自己的理解，写下来今天这一篇笔记！

---

目录

C# 特性貌似有三种：Obsolete、Conditional、AttributeUsage；

---

Obsolete

它的作用是提示一个方法已过期或者直接报错！

有时候，在一些大型项目中，难免会有一些许久，已经过时的了函数，但是又不想删除，为了防止一些新的程序员不知道会调用，所以就得用到它。

他有一个参数和两个参数。

一个参数：

[Obsolete("此类已经过期啦！")]

一个参数时，它默认第二个参数时false。

两个参数：

[Obsolete("此类已经过期啦！", true)]

true：表明该方法不可被调用
false：会有警告⚠

代码示例:

class Attributes {
    [Obsolete("此类已经过期啦！", false)]
    public void ObsoleteTest() {
        Console.WriteLine("测试函数：Obsolete");
    }
}

为false时Mian函数截图：

为true时Mian函数截图:

---

Conditional

我个人理解是：使用这个特性可以将一些我们暂时还不用的，或者以后都不用的方法都给隐藏调用（即使Main函数调用了，代码也不会执行），当需要用到是再解开隐藏使用！

它位于using System.Diagnostics;中

得配合#define一起使用！

他只有一个参数（string类型）：

[Conditional("TEXT")]

当在函数的上面写下了这个特性，该函数既被隐藏掉了！

class Attributes {
    [Conditional("TEXT")]	// 定义特性
    public void ConditionalTest() {
        Console.WriteLine("测试函数：Conditional");
    }

    [Conditional("Text")]
    public void C() {
        Console.WriteLine("又是一个测试 Conditional 的函数！");
    }
}

当在Mian函数中调用：

class Program
{
    static void Main(string[] args) {
        Attributes attributes = new Attributes();
       // attributes.ObsoleteTest();

        attributes.ConditionalTest();
        attributes.C();


        Console.WriteLine("\n按任意键退出...");
        Console.ReadKey();

    }
}

运行截图：

运行出来居然没有打印？？？

其实这个就是因为没有结合#define一起玩，当我们在Mian函数的文件开头加上：#define TEXT 后：

第一条调用attributes.ConditionalTest();的效果打印出来了，但是还有一条的呢？我们只需要再写下一条#defien Text就可以了！

记住：#define中的字符串与Conditional中定义的字符串要一致！

---

AttributeUsage

自定义特性

其实这个自定义特性我也不知道他有什么作用，如果看到此篇的大佬知道的话，麻烦在评论区写下来给我学习学习，谢谢了！！！

他有三个参数：
AttributeTargets：指定特性定义在哪些位置；（必须要有的参数）
AllowMultiple：限定它能否在同一个位置防止多次；（可有可无）
Inherited：限定特性修饰过的类能否被继承。（可有可无）

自定义特性必须继承自：Attribute;
且派生类类名必须以Attribute结尾。

用法：

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

第一个参数：AttributeTargets

[AttributeUsage(AttributeTargets.Class)]	// 定义自定义特性
class HelpAttribute : Attribute {			// 必须继承自Attribute
    public HelpAttribute(string str) {
        this.str = str;
    }
    
     public string Str {
        get {
            return this.str;
        }
    }

    private string str;
}

// 自定义特性的使用*************
[Help("这是一个自定义的特性！")]	// 使用不需加上Attribute也可以！
class Test {
    public void Print() {
        Console.WriteLine("测试自定义特性！");
    }
}

这样子是正确的，但是我们定义参数是：AttributeTargets.Class，限制他只能用在类的前面一行，所以当我们写在函数上面一行时：

他就已经报错了！！！

当然还有很多，例如：AttributeTargets.All，这是适用于全部，等等，
具体其他的用法我也就不列出来了，有想法的朋友可以自行百度去学学！

第二个参数：AllowMultiple

[AttributeUsage(AttributeTargets.Class, AllowMultiple = false)]
class HelpAttribute : Attribute {
    public HelpAttribute(string str) {
        this.str = str;
    }

    public string Str {
        get {
            return this.str;
        }
    }
     private string str;
}


[Help("这是一个自定义的特性！")]
class Test {

    public void Print() {
        Console.WriteLine("测试自定义特性！");
    }
}

true：允许可以多个特性同时修饰
false：不允许可以多个特性同时修饰

这样子是正确的，当我们使用多条特性修饰时：

可以看出已经显示报错了，当我们把false改为true时，这又是可以的，有想法的朋友可以试一下！！

第三个参数：Inherited

[AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false)]
class HelpAttribute : Attribute {
    public HelpAttribute(string str) {
        this.str = str;
    }

    public string Str {
        get {
            return this.str;
        }
    }

    private string str;
}


[Help("这是一个自定义的特性！")]
class Test {

    public void Print() {
        Console.WriteLine("测试自定义特性！");
    }
}

其实这个在我测试当我并没有报错，所以我也不知道第三个参数是干嘛的，但是度娘都说是限制派生类继承的，所以我也是很懵逼。。。

知道的朋友记得评论区写下来供大家学习学习哈！！！

---

总结：
好了，今天的笔记差不多就是这样了，再深入的话我也不会了，有什么错误的地方欢迎各位大佬指正！