C#條件編譯、內(nèi)聯(lián)函數(shù)、CLS介紹
1、條件編譯
#if 條件編譯會隱藏非條件(#else if)代碼,我們開發(fā)中很可能會忽略掉這部分代碼,當(dāng)我們切換條件常量到這部分代碼時,很可能因為各種原因?qū)е聢箦e。
如果使用特性進行條件編譯標(biāo)記,在開發(fā)過程中就可以留意到這部分代碼。
[Conditional("DEBUG")]
例如,當(dāng)使用修改所有引用-修改一個類成員變量或者靜態(tài)變量名稱時,#if 非條件中的代碼不會被修改,因為這部分代碼“無效”,而且使用 [Conditional("DEBUG")] 的代碼則跟條件無關(guān),會被同步修改。
Conditional 特性標(biāo)記的方法等,在開發(fā)過程中保持有效,當(dāng)在編譯時可能被排除。
代碼片段只能使用 #if 了,如果是單個方法,則可以使用 Conditional 。
2、MethodImpl 特性
此特性在 System.Runtime.CompilerServices 命名空間中,指定如何實現(xiàn)方法的詳細信息。
內(nèi)聯(lián)函數(shù)使用方法可參考 http://www.dhdzp.com/article/242567.htm
MethodImpl 特性可以影響 JIT 編譯器的行為。
無法使用 MemberInfo.GetCustomAttributes 來獲取此特性的信息,即不能通過獲取特性的方法獲取跟 MethodImpl 有關(guān)的信息(反射),只能調(diào)用 MethodInfo.GetMethodImplementationFlags() 或 ConstructorInfo.GetMethodImplementationFlags () 來檢索。
MethodImpl 可以在方法以及構(gòu)造函數(shù)上使用。
MethodImplOptions 用于設(shè)置編譯行為,枚舉值可組合使用,其枚舉說明如下:
| 枚舉 | 枚舉值 | 說明 |
|---|---|---|
| AggressiveInlining | 256 | 如可能應(yīng)將該方法進行內(nèi)聯(lián)。 |
| AggressiveOptimization | 512 | 此方法包含一個熱路徑,且應(yīng)進行優(yōu)化。 |
| ForwardRef | 16 | 已聲明該方法,但在其他位置提供實現(xiàn)。 |
| InternalCall | 4096 | 該調(diào)用為內(nèi)部調(diào)用,也就是說它調(diào)用了在公共語言運行時中實現(xiàn)的方法。 |
| NoInlining | 8 | 該方法不能為內(nèi)聯(lián)方法。 內(nèi)聯(lián)是一種優(yōu)化方式,通過該方式將方法調(diào)用替換為方法體。 |
| NoOptimization | 64 | 調(diào)試可能的代碼生成問題時,該方法不由實時 (JIT) 編譯器或本機代碼生成優(yōu)化(請參閱 Ngen.exe)。 |
| PreserveSig | 128 | 完全按照聲明導(dǎo)出方法簽名。 |
| Synchronized | 32 | 該方法一次性只能在一個線程上執(zhí)行。 靜態(tài)方法在類型上鎖定,而實例方法在實例上鎖定。 只有一個線程可在任意實例函數(shù)中執(zhí)行,且只有一個線程可在任意類的靜態(tài)函數(shù)中執(zhí)行。 |
| Unmanaged | 4 | 此方法在非托管的代碼中實現(xiàn)。 |
Synchronized 修飾的方法可以避免多線程中的一些問題,但是不建議對公共類型使用鎖定實例或類型上的鎖定,因為 Synchronized 可以對非自己的代碼的公共類型和實例進行鎖定。 這可能會導(dǎo)致死鎖或其他同步問題。
意思是說,如果共享的成員已經(jīng)設(shè)置了鎖,那么不應(yīng)該再在 Synchronized 方法中使用,這樣雙重鎖定容易導(dǎo)致死鎖以及其他問題。
3、CLSCompliantAttribute
指示程序元素是否符合公共語言規(guī)范 (CLS)。
CLS規(guī)范可參考:
https://docs.microsoft.com/en-us/dotnet/standard/language-independence
全局開啟方法:
程序目錄下添加一個 AssemblyAttribytes.cs 文件,或者打開 obj 目錄,找到 AssemblyAttributes.cs 結(jié)尾的文件,如 .NETCoreApp,Version=v3.1.AssemblyAttributes.cs,添加:
using System; // 這行已經(jīng)有的話不要加 [assembly: CLSCompliant(true)]
之后就可以在代碼中使用 [CLSCompliant(true)] 特性。
局部開啟:
也可以放在類等成員上使用:
[assembly: CLSCompliant(true)]
您可以將特性應(yīng)用于 CLSCompliantAttribute 下列程序元素:程序集、模塊、類、結(jié)構(gòu)、枚舉、構(gòu)造函數(shù)、方法、屬性、字段、事件、接口、委托、參數(shù)和返回值。 但是,CLS 遵從性的概念僅適用于程序集、模塊、類型和類型的成員。
程序編譯時默認(rèn)不會檢查代碼是否符合 CLS 要求,但是如果你的可以是公開的(代碼共享、Nuget 發(fā)布等),則建議使用使用 [assembly: CLSCompliant(true)] ,指明你的庫符合 CLS 要求。
在團隊開發(fā)中以及內(nèi)部共享代碼時,高質(zhì)量的代碼尤為重要,所以有必要使用工具檢查代碼,如 roslyn 靜態(tài)分析、sonar 掃描等,也可以使用上面的特性,自動使用 CLS 檢查。
CLS 部分要求:
無符號類型不應(yīng)成為該類的公共接口的一部分(私有成員可以使用),例如 UInt32 這些屬于 C# 的類型,但不是 CLS “標(biāo)準(zhǔn)” 中的。
指針等不安全類型不能與公共成員一起使用,就是公有方法中都不應(yīng)該使用 unsafe 代碼。(私有成員可以使用)。
類名和成員名不應(yīng)重名。雖然 C# 中區(qū)分大小寫,但是 CLS 不建議同名非重載函數(shù),例如 MYTEST 跟 Mytest。
只能重載屬性和方法,不應(yīng)重載運算符。重載運算符容易導(dǎo)致調(diào)用者不知情時出現(xiàn)程序錯誤,并且重載運算符要排查問題十分困難。
我們可以編譯以下代碼,嘗試使用 CLSCompliant :
[assembly: CLSCompliant(true)]
[CLSCompliant(true)]
public class Test
{
public void MyMethod()
{
}
public void MYMETHOD()
{
}
}IDE 中會警告:warning CS3005: 僅大小寫不同的標(biāo)識符“Test.MYMETHOD()”不符合 CLS,編譯時也會提示 Warn。當(dāng)然,不會阻止編譯,也不會影響程序運行。
總之,如果要標(biāo)記一個程序集 CLS 規(guī)范,可以使用 [assembly: CLSCompliant(true)] 特性。
[CLSCompliant(true)] 特性指示這個元素符合 CLS 規(guī)范,這時編譯器或者 IDE 會檢查你的代碼,檢查是否真的符合規(guī)范。
如果偏偏要寫不符合規(guī)范的代碼,則可以使用 [CLSCompliant(false)]。
4、必要時自定義類型別名
C# 也可以定義類型別名。
using intbyte = System.Int32; using intkb = System.Int32; using intmb = System.Int32; using intgb = System.Int32; using inttb = System.Int32;
byte[] fileByte = File.ReadAllBytes("./666.txt");
intmb size = fileByte.Length / 1024;一些情況下,使用別名可以提高代碼可讀性。真實項目不要使用以上代碼,我只是寫個示例,這并不是合適的應(yīng)用場景。
到此這篇關(guān)于C#條件編譯、內(nèi)聯(lián)函數(shù)、CLS的文章就介紹到這了。希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
C# wpf Brush轉(zhuǎn)Hex字符串的實例代碼
這篇文章主要介紹了C# wpf Brush轉(zhuǎn)Hex字符串的實例代碼,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2021-01-01

