C# 特性和索引（C#學習筆記06）

来源:https://www.cnblogs.com/asahiLikka/archive/2019/10/12/11664113.html
-Advertisement-
Play Games

特性 特性（Attribute）是用於在運行時傳遞程式中各種元素（比如類、方法、結構、枚舉、組件等）的行為信息的聲明性標簽。 特性可以當成一個特殊的類看待 列舉特性語法： attribute為特性名稱，positional_parameters, name_parameter是特性屬性，value為 ...


特性

特性（Attribute）是用於在運行時傳遞程式中各種元素（比如類、方法、結構、枚舉、組件等）的行為信息的聲明性標簽。
特性可以當成一個特殊的類看待

列舉特性語法：

 [attribute(positional_parameters, name_parameter = value, ...)] 
 element

attribute為特性名稱，positional_parameters, name_parameter是特性屬性，value為name_parameter屬性的值

三種預定義特性：

.Net Framework 提供了三種預定義的特性：

1. AttributeUsage

該特性描述了用戶定義的特性類如何被使用
AttributeUsage基本結構:

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

示例：

 [AttributeUsage(AttributeTargets.Class | 
 AttributeTargets.Constructor | 
 AttributeTargets.Field | 
 AttributeTargets.Method | 
 AttributeTargets.Property, 
 AllowMultiple = true)]

 

validon規定了該特性能夠被承載，或者說是能夠被那些類型所使用的聲明，如示例中指明瞭該特性只能在Class（類）,constructor（結構體）,Field（欄位），Method（方法），Property（屬性）
AllowMutiple規定是否能被重覆使用，如果為true則能被重覆使用
Inherited規定這個特性是否能被派生類繼承，預設false不可繼承，true則為可繼承

2.Conditional

這個預定義特性標記了一個條件方法，其執行依賴於特定的預處理標識符
它會引起方法調用的條件編譯，取決於指定的值，比如 Debug 或 Trace。例如，當調試代碼時顯示變數的值
Conditional的基本結構：

 [
Conditional( 
 conditionalSymbol 
 )]

使用示例：

#define hong
using System;
using System.Diagnostics;
public class Myclass
{
    [Conditional("hong")]                            //預定義的Conditional特性
    public static void Message(string msg)
    {
        Console.WriteLine(msg);
    }
}
class Test
{
    static void function1()
    {
        Myclass.Message("In Function 1.");
        function2();
    }
    static void function2()
    {
        Myclass.Message("In Function 2.");
    }
    public static void Main()
    {
        Myclass.Message("In Main function.");
        function1();
    }
}

 

該程式預定義了一個巨集:hong，Conditional特性在函數Message中被使用：[Conditional("hong")] 如果沒有該巨集定義則不會執行函數Message

1. 若定義了巨集則程式如上，運行：(Message會被調用）

In Main function.
In Function 1.
In Function 2.
C:\C#\code\Conditional\bin\Debug\netcoreapp3.0\Conditional.exe (進程 18092)已退出，返回代碼為: 0。
若要在調試停止時自動關閉控制台，請啟用“工具”->“選項”->“調試”->“調試停止時自動關閉控制台”。
按任意鍵關閉此視窗...

2. 若將第一行定義巨集註釋：

//#define hong
using System;
using System.Diagnostics;

 

運行（此時Message函數不會被調用，則沒有輸出）：

C:\C#\code\Conditional\bin\Debug\netcoreapp3.0\Conditional.exe (進程 18264)已退出，返回代碼為: 0。
若要在調試停止時自動關閉控制台，請啟用“工具”->“選項”->“調試”->“調試停止時自動關閉控制台”。
按任意鍵關閉此視窗...
3.Obsolete

這個預定義特性標記了不應被使用的程式實體。它可以讓您通知編譯器丟棄某個特定的目標元素。例如，當一個新方法被用在一個類中，但是您仍然想要保持類中的舊方法，您可以通過顯示一個應該使用新方法，而不是舊方法的消息，來把它標記為 obsolete（過時的）。
Obsolete特性結構：

 [Obsolete(          
 message )] 
 
 [Obsolete(       
 message, 
 iserror )]

message:為描述文字，不使用該函數的原因以及替換函數
iserror:為bool值，true則編譯器會把引用了該特性的項目當成錯誤，產生編譯器警告

示例：

    using System;
    public class MyClass
{
    [Obsolete("Don't use OldMethod, use NewMethod instead", true)]
    static void OldMethod()
    {
        Console.WriteLine("It is the old method");
    }
    static void NewMethod()
    {
        Console.WriteLine("It is the new method");
    }
    public static void Main()
    {
        OldMethod();
    }
}

 

運行編譯器會提示錯誤：

 Don't use OldMethod, use NewMethod instead

創建自定義特性的步驟：

  • 聲明自定義特性
  • 構建自定義特性
  • 在目標程式元素上應用自定義特性
  • 通過反射訪問特性

詳細示例在學習完反射後一同進行

反射

反射（Reflection） 對象用於在運行時獲取類型信息。該類位於 System.Reflection 命名空間中，可訪問一個正在運行的程式的元數據。
System.Reflection 命名空間包含了允許您獲取有關應用程式信息及嚮應用程式動態添加類型、值和對象的類。

反射（Reflection）有下列用途：

  1. 它允許在運行時查看屬性（attribute）信息。
  2. 它允許審查集合中的各種類型，以及實例化這些類型。
  3. 它允許延遲綁定的方法和屬性（property）。
  4. 它允許在運行時創建新類型，然後使用這些類型執行一些任務。

查看元數據

using System;
[AttributeUsage(AttributeTargets.All)]                //規定了特性的能承載所有類型
public class HelpAttribute : System.Attribute         //自定義特性HelpAttribute繼承自Attribute基類
{
    public readonly string Url;
    public string Topic   // Topic 是一個表示名字的參數
    {
        get
        {
            return topic;
        }
        set
        {
            topic = value;
        }
    }
    public HelpAttribute(string url)   // url 是一個表示位置的參數
    {
        this.Url = url;
    }
    private string topic;
}
public class OtherAttribute : System.Attribute
{
    public string topic2
    {
        get
        {
            return topic2;
        }
        set
        {
            topic2 = value;
        }
    }
}
[HelpAttribute("Information on the class MyClass")]          //特性被應用到MyClass一個空類中
[OtherAttribute()]                                           //第二個特性
class MyClass
{

}

namespace AttributeAppl
{
    class Program
    {
        static void Main(string[] args)
        {
            System.Reflection.MemberInfo info = typeof(MyClass);          //System.Reflection.MemberInfo初始化
            object[] attributes = info.GetCustomAttributes(true);          //獲取目標類(MyClass）所承載的特性
            for (int i = 0; i < attributes.Length; i++)                    //遍歷所有特性
            {
                System.Console.WriteLine(attributes[i]);
            }
        }
    }
}

 

System.Reflection.MemberInfo info = typeof(MyClass);          
System.Reflection.MemberInfo需要初始化，用於與目標類關聯（MyClass)

結果:(返回了MyClass類所承載的兩個特性)

HelpAttribute
OtherAttribute

C:\C#\code\Feflection\bin\Debug\netcoreapp3.0\Feflection.exe (進程 6244)已退出，返回代碼為: 0。
若要在調試停止時自動關閉控制台，請啟用“工具”->“選項”->“調試”->“調試停止時自動關閉控制台”。
按任意鍵關閉此視窗...

利用特性設置聲明信息並用反射進行訪問

using System;
using System.Reflection;
namespace attribute
{
    [AttributeUsage(AttributeTargets.Class|            //聲明自定義特性，描述自定義特性DebugInfo如何被使用
        AttributeTargets.Constructor|
        AttributeTargets.Field|
        AttributeTargets.Method|
        AttributeTargets.Property,
        AllowMultiple =true)]
    public class DebugInfo : Attribute                 //構建自定義特性
    {
        private int bugNo;          //bug number
        private string developer;
        private string lastReview;  //last reviewed
        public string message;
        public DebugInfo(int BN,string D,string LR)   //構造函數
        {
            this.bugNo = BN;
            this.developer = D;
            this.lastReview = LR;
        }
        public int BugNo
        {
            get
            {
                return bugNo;
            }
        }
        public string Developer
        {
            get
            {
                return developer;
            }
        }
        public string LastReview
        {
            get
            {
                return lastReview;
            }
        }
        public string Message
        {
            set
            {
                message = value;
            }
            get
            {
                return message;
            }
        }
    }
    [DebugInfo(45,"asahi","19/5/1",Message ="can't return type")]          //在目標程式元素上應用自定義特性
    [DebugInfo(50,"Lock","19/9/9",Message ="unable variable")]
    class Rectangle               //矩形類，承載了兩個特性
    {
        protected double length;
        protected double width;
        public Rectangle(double L,double W)
        {
            this.length = L;
            this.width = W;
        }
        [DebugInfo(55,"sayo","19/9/15",Message ="return false")]
        public double getArea()
        {
            return length * width;
        }
        [DebugInfo(60,"katsumi","19/10/1",Message ="output error")]
        public void Display()
        {
            Console.WriteLine("Length={0}", length);
            Console.WriteLine("Width={0}", width);
            Console.WriteLine("Area={0}", getArea());
        }
    }
    class Program
    {
        static void Main(string[] args)
        {
            Rectangle r = new Rectangle(10, 5);
            r.Display();                                      

            Type type = typeof(Rectangle);                    //獲取Rectangle的類型
            //遍歷Rectangle特性
            Console.WriteLine("                   Rectangle類型的特性測試：");
            foreach(object attributes in type.GetCustomAttributes(false))    //獲取Rectangle類型的所有特性，迭代的方式賦予attributes
            {
                DebugInfo debugInfo = (DebugInfo)attributes;  //所有特性轉換為DebugInfo類型
                if (debugInfo != null)
                {
                    Console.WriteLine("Debug number:{0}", debugInfo.BugNo);
                    Console.WriteLine("Developer:{0}", debugInfo.Developer);
                    Console.WriteLine("Last Review:{0}", debugInfo.LastReview);
                    Console.WriteLine("Message:{0}\n", debugInfo.Message);
                }
            }

            Console.WriteLine("           Rectangle類型的所有函數的特性測試：");
            //遍歷方法屬性
            foreach(MethodInfo m in type.GetMethods())      //遍歷type類型即Rectangle類型所有函數
            {
                foreach(object attributes in m.GetCustomAttributes(false))  //遍歷每個函數的特性
                {
                    DebugInfo debugInfo = (DebugInfo)attributes;
                    if (debugInfo != null)
                    {
                        Console.WriteLine("Debug number:{0}", debugInfo.BugNo);
                        Console.WriteLine("Developer:{0}", debugInfo.Developer);
                        Console.WriteLine("Last Review:{0}", debugInfo.LastReview);
                        Console.WriteLine("Message:{0}\n", debugInfo.Message);
                    }
                }
            }
        }
    }
}

結果：

Length=10
Width=5
Area=50
                   Rectangle類型的特性測試：
Debug number:45
Developer:asahi
Last Review:19/5/1
Message:can't return type

Debug number:50
Developer:Lock
Last Review:19/9/9
Message:unable variable

           Rectangle類型的所有函數的特性測試：
Debug number:55
Developer:sayo
Last Review:19/9/15
Message:return false

Debug number:60
Developer:katsumi
Last Review:19/10/1
Message:output error


C:\Program Files\dotnet\dotnet.exe (進程 8772)已退出，返回代碼為: 0。
若要在調試停止時自動關閉控制台，請啟用“工具”->“選項”->“調試”->“調試停止時自動關閉控制台”。
按任意鍵關閉此視窗...

參考鏈接：

https://www.w3cschool.cn/wkcsharp/8jib1nvi.html

https://www.w3cschool.cn/wkcsharp/9phg1nvl.html


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 30段極簡Python代碼：這些小技巧你都Get了麽
    學 Python 怎樣才最快，當然是實戰各種小項目，只有自己去想與寫，才記得住規則。本文是 30 個極簡任務，初學者可以嘗試著自己實現；本文同樣也是 30 段代碼，Python 開發者也可以看看是不是有沒想到的用法。 Python 是機器學習最廣泛採用的編程語言，它最重要的優勢在於編程的易用性。如果 ...
  • 1.2python基礎_數字類型_數字(Number)類型
    一、整型（int型、整數） 整型 等價於C中的有符號長整型（long） 與系統的最大整型一致（如32位機器上的整型是32位，64位機器上的整型是64位）， 可以表示的整數範圍在[-sys.maxint-1, sys.maxint]之間。整型字面值的表示方法有3種： 十進位（常用）、八進位（以數字“0 ...
  • 你見過的最全面的 Python 重點
    由於總結了太多的東西，所以篇幅有點長，這也是我"縫縫補補"總結了好久的東西。 Py2 VS Py3 print成為了函數，python2是關鍵字 不再有unicode對象，預設str就是unicode python3除號返回浮點數 沒有了long類型 xrange不存在，range替代了xrange ...
  • yzoj 2372 小B的數字 題解
    題意 判斷是否存在一個序列 $ b_i $ 使得 $ \prod_{i = 1}^{n} b_i \ | b_i^{a_i}$ 恆成立，其中 $ b_i $ 中的每個數都是2的正整數次冪。 樣例輸入 樣例輸出 數據範圍 對於 100% 的數據有 $ n \leq 10^5,a_i \leq 10,T ...
  • TinyXML2的快速實踐
    最近遇到個需要在C++中處理XML文件的需求，雖然對此方面並不是很熟，但好在有GitHub上的 "awesome cpp" 項目的幫助，還是收穫了足夠的相關知識。 類庫 常用的或被推薦的XML類庫有以下數個選項，不過相較於純C完成的類庫個人還是更傾向於C++的類庫： Boost.PropertyTr ...
  • springboot項目里，讓tk-mybatis支持可以手寫sql的mapper.xml文件
    SpringBoot項目通常配合TKMybatis或MyBatis-Plus來做數據的持久化。 對於單表的增刪改查，TKMybatis優雅簡潔，無需像傳統mybatis那樣在mapper.xml文件里定義sql。 我們目前的項目呢，有一些數據分析的需求，涉及到多表關聯、嵌套子查詢等複雜的sql。 那 ...
  • else塊的用途
    除了在if...else...中使用，else塊還可以在for迴圈、while迴圈以及try...except中使用。 在for迴圈中使用： 輸出為： 在for迴圈中，else塊只有當for迴圈正常結束時才調用。如果for迴圈被任意其他操作打斷，導致迴圈沒有正常結束時else塊是不會運行的。 在wh ...
  • ABP進階教程5 - 佈局配置
    點這裡進入ABP進階教程目錄 解讀參數 l - length changing input control (左上，每頁顯示記錄數) f - filtering input (右上，過濾條件) t - The table (中央，數據表格) i - Table information summary ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類