Поделиться через


Задача 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>

См. также

Ссылки

Задача RegisterAssembly

Основные понятия

Задачи MSBuild

Другие ресурсы

Справочные сведения о задачах MSBuild