Udostępnij za pośrednictwem

UnregisterAssembly — zadanie

  • Artykuł

Wyrejestrowuje określone zestawy dla celów międzyoperacyjnych MODELU COM. Wykonuje odwrotnie zadania RegisterAssembly.

Parametry

W poniższej tabeli opisano parametry UnregisterAssembly zadania.

Parametr Opis
Assemblies Opcjonalny ITaskItem[] parametr.

Określa zestawy do wyrejestrowania.
AssemblyListFile Opcjonalny ITaskItem parametr.

Zawiera informacje o stanie między RegisterAssembly zadaniem a UnregisterAssembly zadaniem. Zapobiega to próbie wyrejestrowania zestawu, którego nie można zarejestrować w zadaniu RegisterAssembly .

Jeśli ten parametr zostanie określony, Assemblies parametry i TypeLibFiles zostaną zignorowane.
TypeLibFiles Opcjonalny ITaskItem[] parametr wyjściowy.

Wyrejestrowuje określoną bibliotekę typów z określonego zestawu. Uwaga: ten parametr jest wymagany tylko wtedy, gdy nazwa pliku biblioteki typów jest inna niż nazwa zestawu.

Uwagi

Nie jest wymagane, aby zestaw istniał do pomyślnego wykonania tego zadania. Jeśli spróbujesz wyrejestrować zestaw, który nie istnieje, zadanie zakończy się powodzeniem z ostrzeżeniem. Dzieje się tak, ponieważ zadanie tego zadania polega na usunięciu rejestracji zestawu z rejestru. Jeśli zestaw nie istnieje, nie znajduje się w rejestrze i dlatego zadanie zakończyło się pomyślnie.

Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z AppDomainIsolatedTaskExtension klasy, która sama dziedziczy z MarshalByRefObject klasy. Klasa MarshalByRefObject udostępnia te same funkcje co Task klasa, ale może zostać utworzone w własnej domenie aplikacji.

Przykład

W poniższym przykładzie użyto UnregisterAssembly zadania do wyrejestrowania zestawu w ścieżce określonej przez OutputPath właściwości i FileName , jeśli istnieje.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <PropertyGroup>
        <OutputPath>\Output\</OutputPath>
        <FileName>MyFile.dll</FileName>
    </PropertyGroup>
    <Target Name="UnregisterAssemblies">
        <UnregisterAssembly
            Condition="Exists('$(OutputPath)$(FileName)')"
            Assemblies="$(OutputPath)$(FileName)" />
    </Target>

</Project>

Zobacz też