使用 AssemblyVersion 和 AssemblyFileVersion 屬性

本文說明如何使用 AssemblyInfo.cs 檔案 AssemblyVersion AssemblyFileVersion 中的和屬性。

原始產品版本:  .NET Framework
原始 KB 編號:  556041

摘要

AssemblyInfo.cs 提供兩個屬性來設定兩種不同類型的版本。 此秘訣會顯示如何使用這兩個屬性。

Microsoft .NET framework 可讓您有機會將兩種不同類型的版本編號設定為每個元件。

AssemblyVersion

在組建期間和執行時間時,它是框架所用的版本號碼,用來尋找、連結及載入元件。 當您將參照新增至專案中的任何元件時,它就是內嵌的此版本號碼。 在執行時間中,常見語言 Runtime (CLR) 會尋找要載入此版本號碼的元件。 不過,請記住,只有在元件是強式名稱簽署的情況下,此版本才會搭配名稱、公開金鑰標記和區域性資訊使用。 如果元件不是強式名稱簽署的,只會使用檔案名進行載入。

AssemblyFileVersion

這是檔案系統中指定的檔案的版本號碼。 它會由 Windows Explorer 顯示,而且不會供 .NET framework 或 runtime 用來參照。

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