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

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

См. также

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

Задачи MSBuild

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

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