Condividi tramite

RegisterAssembly (attività)

  • Articolo

Legge i metadati all'interno dell'assembly specificato e aggiunge le voci necessarie al Registro di sistema, consentendo ai client COM di creare classi .NET Framework in modo trasparente. Il comportamento di questa attività è simile, ma non identico, a quello di Regasm.exe (strumento di registrazione dell'assembly).

Parametri

Nella tabella che segue vengono descritti i parametri dell'attività RegisterAssembly.

Parametro Descrizione
Assemblies Parametro ITaskItem[] obbligatorio.

Specifica gli assembly da registrare con COM.
AssemblyListFile Parametro ITaskItem facoltativo.

Contiene informazioni sullo stato tra l'attività RegisterAssembly e l'attività UnregisterAssembly. Questo impedisce all'attività UnregisterAssembly di tentare l'annullamento della registrazione di un assembly che non è riuscita nell'attività RegisterAssembly.
CreateCodeBase Parametro Boolean facoltativo.

Se true, viene creata una voce della codebase nel Registro di sistema, che specifica il percorso di un assembly non installato nella Global Assembly Cache. È consigliabile non specificare questa opzione se successivamente si intende installare nella Global Assembly Cache l'assembly che si sta registrando.
TypeLibFiles Parametro di output ITaskItem[] facoltativo.

Specifica la libreria dei tipi da generare dall'assembly specificato. La libreria dei tipi generata contiene le definizioni dei tipi accessibili definiti all'interno dell'assembly. La libreria dei tipi viene generata solo se viene soddisfatta una delle condizioni seguenti:

- Nel percorso specificato non è presente una libreria dei tipi con lo stesso nome.
- La libreria dei tipi esistente è precedente all'assembly passato.

Se la libreria dei tipi è successiva all'assembly passato, non ne verrà creata una nuova ma l'assembly verrà comunque registrato.

Se questo parametro è specificato, è necessario che contenga lo stesso numero di elementi del parametro Assemblies. In caso contrario, l'attività avrà esito negativo. Se non è specificato alcun valore, il nome dell'assembly verrà usato per impostazione predefinita e l'estensione dell'elemento verrà modificata in tlb.

Osservazioni:

Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe TaskExtension, che a sua volta eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

Esempio

Nell'esempio seguente l'attività RegisterAssembly viene usata per registrare l'assembly specificato dalla raccolta di elementi MyAssemblies.

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

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

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

</Project>

Vedi anche