在程式碼中設定組件屬性

  • 發行項

組件屬性是提供組件相關資訊的值。 這些屬性通常會設定在 AssemblyInfo.cs 檔案中。 屬性可分成下列幾組資訊：

  • 組件識別屬性
  • 資訊屬性
  • 組件資訊清單屬性
  • 強式名稱屬性

本文的範圍是從程式碼新增組件屬性。 如需將組件屬性新增至專案 (非程式碼中) 的資訊，請參閱在專案檔案中設定組件屬性。

組件識別屬性

三個屬性連同強式名稱 (如果適用) 會判斷組件的識別：名稱、版本與文化特性。 這些屬性會形成組件的完整名稱，且在參考程式碼中的組件時會需要用到。 您可以使用屬性來設定組件的版本和文化特性。 編譯器或 組件連結器 (Al.exe) 會在建立組件時，以包含組件資訊清單的檔案為基礎來設定名稱值。

下表說明版本與文化特性屬性。

組件識別屬性 描述
AssemblyCultureAttribute 列舉的欄位，會指出組件所支援的文化特性。 組件也可以指定文化特性獨立性，表示其包含預設文化特性的資源。 注意：執行階段會將任何未將文化特性屬性設為 null 的組件作為附屬組件。 這類組件會受限於附屬組件繫結規則。 如需詳細資訊，請參閱執行階段如何找出組件。
AssemblyFlagsAttribute 此值用以設定組件屬性，例如組件是否可並存執行。
AssemblyVersionAttribute 格式為 major.minor.build.revision 的數值 (例如 2.4.0.0)。 通用語言執行平台會使用此值來執行強式名稱組件中的繫結作業。 注意：如果 AssemblyInformationalVersionAttribute 屬性未套用到組件，則 AssemblyVersionAttribute 屬性所指定的版本號碼會由 Application.ProductVersion、Application.UserAppDataPath 與 Application.UserAppDataRegistry 屬性所使用。

下列程式碼範例顯示如何將版本與文化特性屬性套用至組件。

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")];
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")];

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")]

' Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
' Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>

資訊屬性

您可以使用資訊屬性，以提供組件其他的公司或產品資訊。 下表說明可套用至組件的資訊屬性。

資訊屬性 描述
AssemblyCompanyAttribute 此字串值指定公司名稱。
AssemblyCopyrightAttribute 此字串值指定著作權資訊。
AssemblyFileVersionAttribute 此字串值指定 Win32 檔案版本號碼。 這通常會預設為組件版本。
AssemblyInformationalVersionAttribute 此字串值指定的版本資訊不為通用語言執行平台所用，例如完整的產品版本號碼。 注意：如果這個屬性會套用至組件，則其所指定的字串可以在執行階段透過使用 Application.ProductVersion 屬性加以取得。 字串也會在 Application.UserAppDataPath 與 Application.UserAppDataRegistry 屬性所提供的路徑及登錄機碼中使用。
AssemblyProductAttribute 此字串值指定產品資訊。
AssemblyTrademarkAttribute 此字串值指定商標資訊。

這些屬性可以出現在組件的 Windows 內容頁面上，或可以使用 /win32res 編譯器選項加以覆寫，以指定您的 Win32 資源檔。

組件資訊清單屬性

您可以使用組件資訊清單屬性，在組件資訊清單中提供資訊，包括標題、描述、預設別名以及設定。 下表說明組件資訊清單屬性。

組件資訊清單屬性 描述
AssemblyConfigurationAttribute 此字串值表示組件的設定，例如 Retail 或 Debug。 執行階段不使用此值。
AssemblyDefaultAliasAttribute 此字串值指定可供參考組件使用的預設別名。 此值會在組件本身的名稱不容易記時 (例如 GUID 值) 提供易記名稱。 也可以使用此值作為完整組件名稱的簡短形式。
AssemblyDescriptionAttribute 此字串值指定簡短描述，該描述彙總組件的本質與用途。
AssemblyTitleAttribute 此字串值指定組件的易記名稱。 例如，名為 comdlg 的組件可能會以「Microsoft 通用對話方塊控制項」作為標題。

強式名稱屬性

您可以使用強式名稱屬性來設定組件的強式名稱。 下表說明強式名稱屬性。

強式名稱屬性 描述
AssemblyDelaySignAttribute 此布林值表示正在使用延遲簽章。
AssemblyKeyFileAttribute 此字串值表示檔案名稱，該檔案包含公開金鑰 (如果使用延遲簽章) 或公開與私密金鑰，而金鑰以參數形式傳遞至該屬性的建構函式。 請注意檔案名稱是相對於輸出檔案路徑 (.exe 或 .dll)，而非來源檔案路徑。
AssemblyKeyNameAttribute 表示內含金鑰組的金鑰容器，而該金鑰組以參數形式傳遞至該屬性的建構函式。

下列程式碼範例顯示，使用延遲簽署來建立強式名稱組件時所要套用的屬性，而該組件具有名為 myKey.snk 的公開金鑰檔案。

[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];

[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]

<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>

另請參閱