Reference.CopyLocal 屬性

決定是否複製參考到本地的 bin 路徑。

命名空間: VSLangProj
組件: VSLangProj (在 vslangproj.dll 中)

語法

'宣告
'用途

屬性值

布林值 (Boolean)。

備註

在執行階段時,組件必須位於下列兩個位置其中之一:專案的輸出路徑或全域組件快取區 (請參閱使用組件和全域組件快取)。如果專案中包含不在這些位置的物件的參考,那麼當專案建置 (Build) 時,必須將參考複製到專案的輸出路徑。CopyLocal 屬性 (Property) 用來表示是否需要複製。true 表示在執行階段中,參考會複製到專案的輸出路徑。如果為 false,就不會複製參考。

Common Language Runtime 不會追蹤參考的變更來決定是否需要更新本地的複本。變更的追蹤是由專案系統執行。只要使用者不覆寫 CopyLocal 屬性 (Property),必要時專案系統將自動更新此值。

CopyLocal 的專案指定值依下列順序決定:

  1. 如果參考是另一個專案,稱為專案對專案參考,則值為 true

  2. 如果在全域組件快取區中找到組件,則值為 false

  3. mscorlib.dll 參考的值為 false,這是特殊狀況。

  4. 如果在 Framework SDK 資料夾中找到組件,則值為 false

  5. 否則為 true

範例

請參閱 Reference 中的範例。

請參閱

參考

Reference 介面
Reference 成員
VSLangProj 命名空間