RegisterAssembly-Aufgabe

  • Artikel

Liest die Metadaten in der angegebenen Assembly und fügt die erforderlichen Einträge zur Registrierung hinzu. COM-Clients sind so in der Lage, .NET Framework-Klassen transparent zu erstellen. Das Verhalten dieser Aufgabe ähnelt dem von Regasm.exe (Assemblyregistrierungstool), ist aber nicht identisch.

Parameter

In der folgenden Tabelle werden die Parameter der RegisterAssembly -Aufgabe beschrieben.

Parameter Beschreibung
Assemblies Erforderlicher ITaskItem[]-Parameter.

Gibt die mit COM zu registrierenden Assemblys an.
AssemblyListFile Optionaler ITaskItem-Parameter.

Enthält Informationen zum Zustand zwischen der RegisterAssembly-Aufgabe und der UnregisterAssembly-Aufgabe. Diese Informationen verhindern, dass die UnregisterAssembly-Aufgabe versucht, die Registrierung einer Assembly aufzuheben, die in der RegisterAssembly-Aufgabe nicht registriert werden konnte.
CreateCodeBase Optionaler Boolean-Parameter.

Wenn true, wird ein Codebase-Eintrag in der Registrierung erstellt, der den Dateipfad für eine Assembly festlegt, die nicht im globalen Assemblycache installiert ist. Die Option sollte nicht angegeben werden, wenn Sie die zu registrierende Assembly später 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 in der Assembly definierten Typen, auf die zugegriffen werden kann. Die Typbibliothek wird nur generiert, wenn eine der folgenden Bedingungen zutrifft:

- Eine Typbibliothek mit diesem Namen ist an diesem Speicherort nicht vorhanden.
- Eine Typbibliothek ist vorhanden, jedoch älter als die übergebene Assembly.

Wenn die Typbibliothek neuer ist als die übergebene Assembly, wird keine neue erstellt, aber die Assembly wird immer noch registriert.

Wenn dieser Parameter angegeben wird, muss er die gleiche Anzahl von Elementen wie der Assemblies-Parameter haben, oder bei der Aufgabe tritt ein Fehler auf. Wenn keine Eingaben angegeben werden, erhält 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 von der Elementsammlung MyAssemblies angegebene Assembly mithilfe der RegisterAssembly-Aufgabe registriert.

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

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

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

</Project>

Weitere Informationen