Reference.CopyLocal 属性

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

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

语法

声明
Property CopyLocal As Boolean
    Get
    Set
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)

属性值

类型:System.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 命名空间