RegisterAssembly — zadanie
Odczytuje metadane w określonym zestawie i dodaje niezbędne wpisy do rejestru, co umożliwia klientom COM tworzenie klas programu .NET Framework w sposób niewidoczny. Zachowanie tego zadania jest podobne, ale nie identyczne z zachowaniem narzędzia Regasm.exe (narzędzie rejestracji zestawu).
Parametry
W poniższej tabeli opisano parametry RegisterAssembly zadania.
| Parametr | Opis |
|---|---|
Assemblies |
Wymagany parametr interfejsu ITaskItem[].Określa zestawy do zarejestrowania w modelu COM. |
AssemblyListFile |
Opcjonalny ITaskItem parametr. Zawiera informacje o stanie między zadaniem a RegisterAssembly wyrejestrowywaniemZasłanie. Te informacje uniemożliwiają UnregisterAssembly zadaniu próbę wyrejestrowania zestawu, którego nie można zarejestrować w RegisterAssembly zadaniu. |
CreateCodeBase |
Opcjonalny Boolean parametr.Jeśli trueprogram tworzy wpis bazy kodu w rejestrze, który określa ścieżkę pliku dla zestawu, który nie jest zainstalowany w globalnej pamięci podręcznej zestawów. Nie należy określać tej opcji, jeśli później instalowany będzie zestaw, który jest rejestrowany w globalnej pamięci podręcznej zestawów. |
TypeLibFiles |
Opcjonalny ITaskItem[] parametr wyjściowy.Określa bibliotekę typów do wygenerowania na podstawie określonego zestawu. Wygenerowana biblioteka typów zawiera definicje typów dostępnych zdefiniowanych w zestawie. Biblioteka typów jest generowana tylko wtedy, gdy spełniony jest jeden z następujących warunków: - Biblioteka typów tej nazwy nie istnieje w tej lokalizacji. — Biblioteka typów istnieje, ale jest starsza niż przekazywany zestaw. Jeśli biblioteka typów jest nowsza niż przekazany zestaw, nowy nie zostanie utworzony, ale zestaw będzie nadal zarejestrowany. Jeśli ten parametr zostanie określony, musi mieć taką samą liczbę elementów jak Assemblies parametr lub zadanie zakończy się niepowodzeniem. Jeśli nie określono żadnych danych wejściowych, zadanie będzie domyślnie mieć nazwę zestawu i zmienić rozszerzenie elementu na .tlb. |
Uwagi
Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z TaskExtension klasy, która sama dziedziczy z Task klasy. Aby uzyskać listę tych dodatkowych parametrów i ich opisy, zobacz TaskExtension, klasa bazowa.
Przykład
W poniższym przykładzie użyto RegisterAssembly zadania do zarejestrowania zestawu określonego MyAssemblies przez kolekcję elementów.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyAssemblies Include="MyAssembly.dll" />
<ItemGroup>
<Target Name="RegisterAssemblies">
<RegisterAssembly
Assemblies="@(MyAssemblies)" >
</Target>
</Project>