Reference.CopyLocal 属性

确定是否将引用复制到本地 Bin 路径。

命名空间:  VSLangProj
程序集:  VSLangProj(在 VSLangProj.dll 中)

语法

声明
Property CopyLocal As Boolean
bool CopyLocal { get; set; }
property bool CopyLocal {
    bool get ();
    void set (bool value);
}
abstract CopyLocal : bool with get, set
function get CopyLocal () : boolean 
function set CopyLocal (value : boolean)

属性值

类型:Boolean
布尔型。

备注

运行时,程序集必须位于下列两个位置之一:项目的输出路径或全局程序集缓存(请参见 使用程序集和全局程序集缓存)。 如果项目包含对某个对象的引用而该对象不在这两个位置之一,则在生成项目时,必须将引用复制到项目的输出路径。 CopyLocal 属性指示是否需要进行此复制。 如果该值为 true,则在运行时将引用复制到项目的输出路径。 如果为 false,则不复制引用。

公共语言运行时不跟踪对引用的更改来确定本地副本是否需要更新。 更改是由项目系统跟踪的。 只要用户不重写 CopyLocal 属性,项目系统就会在需要时自动更新该值。

项目分配的 CopyLocal 值按以下顺序确定:

  1. 如果引用是另一个项目(称为项目到项目的引用),则该值为 true。

  2. 如果在全局程序集缓存中找到该程序集,则该值为 false。

  3. 作为特例,mscorlib.dll 引用的值为 false。

  4. 如果在 Framework SDK 文件夹中找到该程序集,则该值为 false。

  5. 否则,该值为 true。

示例

请参见 Reference中的示例。

.NET Framework 安全性

请参阅

参考

Reference 接口

VSLangProj 命名空间