Reference.CopyLocal - свойство
Обновлен: Ноябрь 2007
Задается, должна ли ссылка копироваться в локальную папку Bin.
Пространство имен: VSLangProj
Сборка: VSLangProj (в VSLangProj.dll)
Синтаксис
'Декларация
Property CopyLocal As Boolean
'Применение
Dim instance As Reference
Dim value As Boolean
value = instance.CopyLocal
instance.CopyLocal = value
bool CopyLocal { get; set; }
property bool CopyLocal {
bool get ();
void set (bool value);
}
function get CopyLocal () : boolean
function set CopyLocal (value : boolean)
Значение свойства
Тип: System.Boolean
Логическое значение.
Заметки
Во время выполнения построения должны находиться либо в папке выходных файлов проекта, либо в глобальном кэше сборок (см. раздел Работа со сборками и глобальным кэшем сборок). Если проект содержит ссылку на объект, не находящийся ни в одном из этих расположений, то после построения проекта ссылка должна быть скопирована в выходной путь проекта. Свойство CopyLocal указывает, нужно ли копировать эту ссылку. Если это свойство имеет значение true, то во время выполнения данная ссылка копируется в выходной путь проекта. Если атрибут имеет значение false, ссылка не копируется.
Среда CLR не отслеживает изменения, происходящие со ссылкой, чтобы определить, нужно ли обновлять локальную копию. Изменения отслеживаются в системе проекта. Пока пользователь не переопределит свойство CopyLocal, при необходимости система проекта будет автоматически обновлять значение.
Задаваемое в проекте значение свойства CopyLocal определяется в следующем порядке:
Если это ссылка на другой проект, называемая ссылкой между проектами, то свойство имеет значение true.
Если сборка находится в глобальном кэше сборок, то свойство имеет значение false.
Как особый случай, значение этого свойства для ссылки mscorlib.dll ― false.
Если сборка находится в папке Framework SDK, то значение этого атрибута – false.
В противном случае – true.
Примеры
См. пример в разделе Reference.
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.