Задача UnregisterAssembly
Отменяет регистрацию указанных сборок для взаимодействия COM.Выполняет задачу, обратную задаче регистрации сборки.
Параметры
В следующей таблице описаны параметры задачи UnregisterAssembly.
Параметр |
Описание |
---|---|
Assemblies |
Необязательный параметр ITaskItem[] . Задает сборки, для которых отменяется регистрация. |
AssemblyListFile |
Необязательный параметр типа ITaskItem. Содержит сведения о состоянии взаимодействия между задачами RegisterAssembly и UnregisterAssembly.Это препятствует попытке задачи отменить регистрацию сборки, которая не смогла зарегистрироваться в задаче RegisterAssembly. Если параметр задан, то параметры Assemblies и TypeLibFiles игнорируются. |
TypeLibFiles |
Необязательный выходной параметр типа ITaskItem[]. Отменяет регистрацию библиотеки указанного типа в заданной сборке.
Примечание
Этот параметр требуется, только если имя файла библиотеки типов отличается от имени сборки.
|
Заметки
Для успеха не требуется, чтобы сборка существовала для этой задачи.При попытке отменить регистрацию несуществующей сборки задача выполнится с предупреждением.Это происходит из-за того, что это задание для этой задачи удалить регистрацию сборки из системного реестра.Если сборка не существует, то она не находится в системном реестре, поэтому задача выполняется успешно.
Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса AppDomainIsolatedTaskExtension, который наследует от класса MarshalByRefObject.MarshalByRefObject предоставляет те же функции, что и класс Task, и поэтому его экземпляры можно создавать в собственном домене приложения.
Пример
В следующем примере задача UnregisterAssembly используется, чтобы отменить регистрацию сборки, путь к которой задан свойствами OutputPath и FileName, если он существует.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup>
<OutputPath>\Output\</OutputPath>
<FileName>MyFile.dll</FileName>
</PropertyGroup>
<Target Name="UnregisterAssemblies">
<UnregisterAssembly
Condition="Exists('$(OutputPath)$(FileName)')"
Assemblies="$(OutputPath)$(FileName)" />
</Target>
</Project>