UnregisterAssembly 작업

  • 아티클

COM interop 용도로 지정된 어셈블리의 등록을 취소합니다. RegisterAssembly 작업의 역작업을 수행합니다.

매개 변수

다음 표에서는 UnregisterAssembly 작업의 매개 변수에 대해 설명합니다.

매개 변수 Description
Assemblies 선택적 ITaskItem[] 매개 변수입니다.

등록을 취소할 어셈블리를 지정합니다.
AssemblyListFile 선택적 ITaskItem 매개 변수입니다.

RegisterAssembly 작업 및 UnregisterAssembly 작업 간의 상태 정보를 포함합니다. 이를 통해 작업이 RegisterAssembly 작업에서 등록되지 못한 어셈블리의 등록을 취소하려고 하는 시도를 방지합니다.

이 매개 변수를 지정하는 경우 Assemblies 및 TypeLibFiles 매개 변수는 무시됩니다.
TypeLibFiles 선택적 ITaskItem[] 출력 매개 변수입니다.

지정된 어셈블리에서 지정된 형식 라이브러리의 등록을 취소합니다. 참고: 이 매개 변수는 형식 라이브러리 파일 이름이 어셈블리 이름과 다른 경우에만 필요합니다.

설명

이 작업이 성공하기 위해 이 어셈블리가 있어야 할 필요는 없습니다. 존재하지 않는 어셈블리의 등록을 취소하려고 하면 작업은 성공하지만 경고가 발생합니다. 이 작업의 해당 작업이 레지스트리에서 어셈블리 등록을 제거하는 것이기 때문입니다. 어셈블리가 없으면 레지스트리에 없으므로 작업은 성공합니다.

이 작업은 위에 나와 있는 매개 변수 외에 MarshalByRefObject 클래스에서 직접 상속하는 AppDomainIsolatedTaskExtension 클래스의 매개 변수도 상속합니다. MarshalByRefObject 클래스는 Task 클래스와 동일한 기능을 제공하지만 해당 애플리케이션 도메인에서 인스턴스화될 수 있습니다.

예시

다음 예제에서는 UnregisterAssembly 작업을 사용하여 OutputPath 및 FileName 속성으로 지정된 경로에서 어셈블리(있는 경우)의 등록을 취소합니다.

<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>

참고 항목