設定組件屬性
組件屬性是提供組件相關資訊的值。 組件屬性可區分成下列資訊組合：
組件識別屬性
資訊屬性
組件資訊清單屬性
強式名稱屬性
組件識別屬性
三種屬性加上強式名稱 (如果有的話) 共同決定組件的識別：名稱、版本和文化特性。 這些屬性將形成組件的完整名稱，而且是在程式碼中參考組件時必須使用的屬性。 您可以使用屬性來設定組件的版本和文化特性。 編譯器或組件連結器 (Al.exe) 可在建立組件時，根據含有組件資訊清單的檔案來設定名稱值。
下表將說明版本和文化特性屬性。
組件識別屬性 |
說明 |
|---|---|
列舉欄位，指出組件支援的文化特性。 組件也可指定文化特性的獨立性，指出組件包含預設文化特性資源。 .gif "注意事項") 注意事項
執行階段將所有未將文化特性屬性設為 null 的組件視為附屬組件。此類組件受致於附屬組件繫結規則 (Rule)。如需詳細資訊，請參閱執行階段如何找出組件。
|
|
設定組件屬性的值，例如是否可並存執行組件。 |
|
格式為 major.minor.build.revision 的數值 (例如 2.4.0.0)。 Common Language Runtime 會使用這個值在強式名稱的組件中執行繫結作業。 注意事項
如果 AssemblyInformationalVersionAttribute 屬性 (Attribute) 未套用至組件，則 AssemblyVersionAttribute 屬性 (Attribute) 指定的版本號碼會由 Application.ProductVersion、Application.UserAppDataPath 和 Application.UserAppDataRegistry 屬性 (Property) 所使用。
|
下列程式碼範例說明如何套用版本和文化特性屬性到組件。
' 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")];
資訊屬性
您可以使用資訊屬性來提供組件的其他公司或產品資訊。 下表說明可套用到組件的資訊屬性。
資訊屬性 |
說明 |
|---|---|
字串值，可指定公司名稱。 |
|
字串值，可指定著作權資訊。 |
|
字串值，可指定 Win32 檔案版本編號。 該字串值的預設值為組件版本。 |
|
字串值，可指定 Common Language Runtime 未使用的版本資訊，例如完整的產品版本號碼。 注意事項
如果此屬性 (Attribute) 套用至組件，則可以在執行階段使用 Application.ProductVersion 屬性 (Property) 取得所指定的字串。此字串也可用於 Application.UserAppDataPath 和 Application.UserAppDataRegistry 屬性提供的路徑和登錄機碼。
|
|
字串值，可指定產品資訊。 |
|
字串值，可指定商標資訊。 |
這些屬性會出現在組件的 Windows 屬性頁，或使用 /win32res 編譯器選項來指定您的 Win32 資源檔，以覆寫這些屬性值。
組件資訊清單屬性
您可以使用組件資訊清單屬性提供組件資訊清單中的資訊，包括標題、說明、預設別名和組態。 下表即說明組件資訊清單屬性。
組件資訊清單屬性 |
說明 |
|---|---|
字串值，指出組件的組態，例如組件是正式版或偵錯版。 執行階段並不會使用這個值。 |
|
字串值，指定參考組件時使用的預設別名。 如果組件的名稱不容易記住 (例如 GUID 值)，該值將提供易記名稱。 該值也可做為完整組件名稱的簡短形式。 |
|
字串值，可指定用來摘要說明組件的性質和作用的簡短說明。 |
|
字串值，可指定組件的易記名稱。 例如，comdlg 組件可使用 Microsoft Common Dialog Control 標題。 |
強式名稱屬性
您可以使用強式名稱屬性來設定組件強式名稱。 下表說明強式名稱屬性。
強式名稱屬性 |
說明 |
|---|---|
布林值，指示目前正使用延遲簽名。 |
|
字串值，指示含有公開金鑰 (如果是使用延遲簽名) 或同時含有公用和私秘金鑰的檔名，被當做引數傳遞給這個屬性的建構函式。 請注意，檔名相對於輸出檔案路徑 (.exe 或 .dll)，而非原始程式檔路徑。 |
|
指出含有金鑰組的金鑰容器被當做引數傳遞給這個屬性的建構函式。 |
下列程式碼範例說明使用延遲簽名來建立使用 myKey.snk 公開金鑰檔的強式名稱組件時，所套用的屬性。
<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>
[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]
[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];