設定組件屬性
更新:2007 年 11 月
組件屬性值會提供關於組件的資訊。組件屬性可區分成下列資訊組合:
組件識別屬性
資訊屬性
組件資訊清單屬性
強式名稱屬性
組件識別屬性
三種屬性加上強式名稱 (如果有的話) 共同決定組件的識別:名稱、版本和文化特性。這些屬性將形成組件的完整名稱,而且是在程式碼中參考組件時必須使用的屬性。您可以使用屬性來設定組件的版本和文化特性。編譯器或組件連結器 (Al.exe) 可在建立組件時,根據含有組件資訊清單的檔案來設定名稱值。
下表將說明版本和文化特性屬性。
組件識別屬性 |
說明 |
||
---|---|---|---|
列舉欄位,指出組件支援的文化特性。組件也可指定文化特性的獨立性,指出組件包含預設文化特性資源。
|
|||
設定組件屬性的值,例如是否可並存執行組件。 |
|||
格式為 major.minor.build.revision 的數值 (例如 2.4.0.0)。Common Language Runtime 會使用這個值在強式名稱的組件中執行繫結作業。
|
下列程式碼範例說明如何套用版本和文化特性屬性到組件。
'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 未使用的版本資訊,例如完整的產品版本號碼。
|
|||
字串值,可指定產品資訊。 |
|||
字串值,可指定商標資訊。 |
這些屬性會出現在組件的 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)]