RegisterAssembly – úloha

  • Článek

Načte metadata v rámci zadaného sestavení a přidá potřebné položky do registru, což umožňuje klientům MODELU COM transparentně vytvářet třídy rozhraní .NET Framework. Chování tohoto úkolu je podobné, ale není identické s chováním Regasm.exe (Nástroj registrace sestavení).

Parametry

Následující tabulka popisuje parametry RegisterAssembly úlohy.

Parametr Popis
Assemblies Požadovaný parametr ITaskItem[].

Určuje sestavení, která mají být registrována pomocí modelu COM.
AssemblyListFile Volitelný ITaskItem parametr.

Obsahuje informace o stavu mezi RegisterAssembly úkolem a unregisterAssembly úkol. Tyto informace brání úkolu v pokusu UnregisterAssembly o zrušení registrace sestavení, které se nepodařilo zaregistrovat v RegisterAssembly úloze.
CreateCodeBase Volitelný Boolean parametr.

Pokud truevytvoří položku základu kódu v registru, která určuje cestu k souboru pro sestavení, které není nainstalováno v globální mezipaměti sestavení. Tuto možnost byste neměli zadávat, pokud následně instalujete sestavení, které budete registrovat do globální mezipaměti sestavení (GAC).
TypeLibFiles Volitelný ITaskItem[] výstupní parametr.

Určuje knihovnu typů, která se má vygenerovat ze zadaného sestavení. Vygenerovaná knihovna typů obsahuje definice přístupných typů definovaných v rámci sestavení. Knihovna typů se vygeneruje pouze v případě, že platí jedna z následujících podmínek:

– Knihovna typů tohoto názvu v tomto umístění neexistuje.
– Knihovna typů existuje, ale je starší než předaná sestavení.

Pokud je knihovna typů novější než předaná sestavení, nebude vytvořena nová, ale sestavení bude stále registrováno.

Pokud je tento parametr zadán, musí mít stejný počet položek jako Assemblies parametr nebo úkol selže. Pokud nejsou zadány žádné vstupy, úloha se ve výchozím nastavení nastaví na název sestavení a změní rozšíření položky na .tlb.

Poznámky

Kromě výše uvedených parametrů tato úloha dědí parametry z TaskExtension třídy, která sama dědí z Task třídy. Seznam těchto dalších parametrů a jejich popisů naleznete v tématu TaskExtension základní třída.

Příklad

Následující příklad používá RegisterAssembly úlohu k registraci sestavení určeného kolekcí MyAssemblies položek.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <MyAssemblies Include="MyAssembly.dll" />
    <ItemGroup>

    <Target Name="RegisterAssemblies">
        <RegisterAssembly
            Assemblies="@(MyAssemblies)" >
    </Target>

</Project>

Viz také