RegisterAssembly-Aufgabe
Liest die Metadaten in der angegebenen Assembly und trägt die erforderlichen Einträge in die Registrierung ein, damit COM-Clients .NET Framework-Klassen transparent erstellen können. Das Verhalten dieser Aufgabe ist mit dem von Regasm.exe (Assembly Registration-Tool) zu vergleichen, jedoch nicht identisch.
Parameter
In der folgenden Tabelle werden die Parameter der RegisterAssembly-Aufgabe beschrieben.
Parameter |
Description |
|---|---|
Assemblies |
Erforderlicher ITaskItem[]-Parameter. Gibt die in COM zu registrierenden Assemblys an. |
AssemblyListFile |
Optionaler ITaskItem-Parameter. Enthält Informationen über den Zustand zwischen der RegisterAssembly-Aufgabe und der UnregisterAssembly-Aufgabe. Dadurch wird verhindert, dass die UnregisterAssembly-Aufgabe versucht, die Registrierung einer Assembly aufzuheben, die in der RegisterAssembly-Aufgabe nicht registriert werden konnte. |
CreateCodeBase |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird in der Registrierung ein CodeBase-Eintrag erstellt, der den Dateipfad einer nicht im globalen Assemblycache installierten Assembly angibt. Die Option sollte nicht angegeben werden, wenn Sie die zu registrierende Assembly nachfolgend im globalen Assemblycache installieren. |
TypeLibFiles |
Optionaler ITaskItem[]-Ausgabeparameter. Gibt die Typbibliothek an, die aus der angegebenen Assembly generiert werden soll. Die generierte Typbibliothek enthält Definitionen der innerhalb der Assembly definierten Typen, auf die zugegriffen werden kann. Die Typbibliothek wird nur generiert, wenn eine der folgenden Voraussetzungen erfüllt ist:
Wenn die Typbibliothek neuer ist als die übergebene Assembly, wird keine neue Typbibliothek erstellt, die Assembly wird jedoch trotzdem registriert. Wenn dieser Parameter angegeben wird, muss er dieselbe Anzahl an Elementen aufweisen wie der Assemblies-Parameter. Andernfalls schlägt die Aufgabe fehl. Werden keine Eingaben angegeben, verwendet die Aufgabe standardmäßig den Namen der Assembly und ändert die Erweiterung des Elements in .tlb. |
Hinweise
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.
Beispiel
Im folgenden Beispiel wird die RegisterAssembly-Aufgabe verwendet, um die von der MyAssemblies-Elementauflistung angegebene Assembly zu registrieren.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyAssemblies Include="MyAssembly.dll" />
<ItemGroup>
<Target Name="RegisterAssemblies">
<RegisterAssembly
Assemblies="@(MyAssemblies)" >
</Target>
</Project>