Задача RegisterAssembly
Считывание метаданных в указанной сборке и добавление необходимых записей в реестр, что позволяет клиентам COM прозрачно создавать классы .NET Framework.Поведение этой задачи аналогично, но не идентично поведению Regasm.exe (средство регистрации сборок).
Параметры
В следующей таблице описаны параметры задачи RegisterAssembly.
Параметр |
Описание |
---|---|
Assemblies |
Обязательный параметр ITaskItem[]. Сборки, регистрируемые с помощью COM. |
AssemblyListFile |
Необязательный параметр типа ITaskItem. Сведения о состоянии между выполнением задач RegisterAssembly и UnregisterAssembly.Это препятствует попытке задачи UnregisterAssembly отменить регистрацию сборки, которую не удалось зарегистрировать в задаче RegisterAssembly. |
CreateCodeBase |
Необязательный параметр типа Boolean. При значении true в реестре создается запись Codebase, задающая путь к файлу сборки, которая не устанавливается в глобальный кэш сборок.Не следует указывать этот параметр, если впоследствии будет установлена сборка, регистрируемая в глобальном кэше сборок. |
TypeLibFiles |
Необязательный выходной параметр типа ITaskItem[]. Библиотека типов, создаваемая из заданной сборки.В созданной библиотеке типов содержатся определения доступных типов, заданных в сборке.Библиотека типов создается, только если справедливо одно из следующих условий:
Если версия библиотеки типов более новая, чем версия для передаваемой сборки, то новая библиотека не будет создана, хотя сборка будет зарегистрирована. Если этот параметр указан, число его элементов должно совпадать с числом элементов для параметра Assemblies, иначе произойдет ошибка выполнения задачи.Если входные данные не указаны, то для сборки в задаче будет назначено имя по умолчанию, а расширение элемента будет изменено на .tlb. |
Заметки
Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса TaskExtension, который наследует от класса Task.Чтобы получить список этих доп параметров и их описаний, см. Базовый класс TaskExtension.
Пример
В следующем примере задача RegisterAssembly используется для регистрации сборки, заданной в коллекции элементов MyAssemblies.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyAssemblies Include="MyAssembly.dll" />
<ItemGroup>
<Target Name="RegisterAssemblies">
<RegisterAssembly
Assemblies="@(MyAssemblies)" >
</Target>
</Project>