本文介紹如何在 AssemblyVersion AssemblyInfo.cs 檔案中使用 和 AssemblyFileVersion 屬性。
原始產品版本: .NET Framework
原始 KB 編號: 556041
摘要
AssemblyInfo.cs提供兩個屬性來定義不同類型的版本號碼。 本文說明如何有效地使用這些屬性。
Microsoft .NET Framework 可讓您將兩種不同類型的版本號碼設定為每個元件。
程序集版本 (AssemblyVersion)
AssemblyVersion 是架構在建置期間和運行時間用來尋找、連結及載入元件的版本號碼。 當您在專案中加入程序集的參考時,此版本號碼會嵌入。 在執行階段,Common Language Runtime (CLR)會使用此版本號來載入元件。
注意:只有在元件具有強名稱(已簽署)時,才會與元件的名稱、公鑰令牌和文化特性資訊搭配使用這個版本。 若元件並非具強式名稱,則只會使用檔名來載入。
AssemblyFileVersion
AssemblyFileVersion 是指派給元件檔案的版本號碼,如同在文件系統中一樣。 它與 Windows 檔案總管一起顯示,但在參考時從不使用 .NET Framework 或執行階段。
AssemblyInfo.cs中的屬性
// Version information for an assembly consists of the following four values:
// Major Version
// Minor Version
// Build Number
// Revision
[assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]
使用星號 \ 取代特定數位,可讓編譯程式在每個組建中自動遞增值。
例如,如果您要建置許多開發人員所使用的框架組件,而且您經常發行新版本(例如每日),而且這些組件具強名稱,開發人員必須在每次發行時更新其參考。 這很麻煩,而且可能會導致參考錯誤。
在這類封閉群組和揮發性案例中,更好的方法是只保留 AssemblyVersion 固定並更新 AssemblyFileVersion。 它可讓開發人員覆寫參考路徑中的元件,而不需要變更其項目參考。
針對主要或最終版本組建,建議更新 AssemblyVersion 以反映重大變更。 在這些情況下, AssemblyFileVersion 通常會更新 ,以符合 AssemblyVersion 一致性。