大多數屬性適用於特定的語言元素,如類別或方法。 然而,有些屬性是全球性的。 它們適用於整個組件或模組。 例如,使用屬性 AssemblyVersionAttribute 將版本資訊嵌入組件中,如下所示:
[assembly: AssemblyVersion("1.0.0.0")]
全域屬性會出現在原始程式碼的任何最上層 using 指示詞後面,以及任何類型、模組或命名空間宣告前面。 你可以在多個原始檔案中包含全域屬性,但必須在一次編譯中完成這些檔案。 在 .NET Framework 專案中,Visual Studio 會在 AssemblyInfo.cs 檔案中加入全域屬性。 這些屬性不會新增至 .NET Core 專案。
C# 語言參考資料記錄了 C# 語言最新版本。 同時也包含即將推出語言版本公開預覽功能的初步文件。
文件中標示了語言最近三個版本或目前公開預覽版中首次引入的任何功能。
小提示
欲查詢某功能何時首次在 C# 中引入,請參閱 C# 語言版本歷史的條目。
組裝屬性提供關於組裝的資訊。 它們的分類如下:
- 組件識別屬性
- 資訊屬性
- 組件資訊清單屬性
組件識別屬性
三個具有強式名稱 (如果適用) 的屬性會判斷組件的識別:名稱、版本與文化特性。 這些屬性會形成組件的完整名稱,且在程式碼中參考組件時需要用到。 你可以透過屬性設定組裝的版本和文化。 不過,你可以在編譯器、Visual Studio IDE 的 組合語言資訊對話框,或是在建立組合語言時用組合語言連結器(Al.exe)設定名稱值。 組件名稱是以組件資訊清單為基礎。 AssemblyFlagsAttribute 屬性指定組件的多個複本是否可以並存。
下表顯示識別屬性。
| 屬性 | 目的 |
|---|---|
| AssemblyVersionAttribute | 指定組件的版本。 |
| AssemblyCultureAttribute | 指定組件所支援的文化特性。 |
| AssemblyFlagsAttribute | 為組件指定旗標的位元組合,描述 Just-In-Time (JIT) 編譯器選項、組件是否可重定目標,以及組件是否具有完整或 Token 化的公開金鑰。 |
資訊屬性
利用資訊屬性提供更多公司或產品資訊,以供組裝。 下表顯示 System.Reflection 命名空間中定義的資訊屬性。
| 屬性 | 目的 |
|---|---|
| AssemblyProductAttribute | 指定組件資訊清單的產品名稱。 |
| AssemblyTrademarkAttribute | 指定組件資訊清單的商標。 |
| AssemblyInformationalVersionAttribute | 指定組件資訊清單的其他版本資訊。 |
| AssemblyCompanyAttribute | 指定組件資訊清單的公司名稱。 |
| AssemblyCopyrightAttribute | 定義自訂屬性,以指定組件資訊清單的版權。 |
| AssemblyFileVersionAttribute | 設定 Win32 檔案版本資源的特定版本號碼。 |
| CLSCompliantAttribute | 表示組件是否符合 Common Language Specification (CLS) 規範。 |
組件資訊清單屬性
使用組裝清單屬性來提供組裝清單中的資訊。 屬性包括標題、描述、預設別名和組態。 下表顯示 System.Reflection 命名空間中定義的資訊清單屬性。
| 屬性 | 目的 |
|---|---|
| AssemblyTitleAttribute | 指定組件資訊清單的組件標題。 |
| AssemblyDescriptionAttribute | 指定組件資訊清單的組件描述。 |
| AssemblyConfigurationAttribute | 指定組件資訊清單的組件設定 (例如零售或偵錯)。 |
| AssemblyDefaultAliasAttribute | 定義一個友善的預設別名,用於組裝清單。 |