UnregisterAssembly Class

Definition

Namespace:

Microsoft.Build.Tasks

Assembly:

Microsoft.Build.Tasks.Core.dll

Package:

Microsoft.Build.Tasks.Core v17.5.0

Registers a managed assembly for COM interop (equivalent of regasm.exe functionality, but this code doesn't actually call the exe).

This API supports the product infrastructure and is not intended to be used directly from your code.

public ref class UnregisterAssembly : Microsoft::Build::Tasks::AppDomainIsolatedTaskExtension

public class UnregisterAssembly : Microsoft.Build.Tasks.AppDomainIsolatedTaskExtension

type UnregisterAssembly = class
    inherit AppDomainIsolatedTaskExtension

Public Class UnregisterAssembly
Inherits AppDomainIsolatedTaskExtension

Inheritance

MarshalByRefObject

AppDomainIsolatedTask

AppDomainIsolatedTaskExtension

UnregisterAssembly

Remarks

Framework64/<version>/UnRegisterAssemblyTask cannot resolve a library of COM objects registered as 32-bit components. Framework/<version>/UnRegisterAssemblyTask cannot resolve a library of COM objects registered as 64-bit components.

For example, if you register a library of COM objects called ClassLibrary1 as 32-bit components on a 64-bit machine, run Visual Studio, and change the target to x64, the build fails with the following error:

ClassLibrary1.dll is not a valid assembly

Constructors

UnregisterAssembly()

This API supports the product infrastructure and is not intended to be used directly from your code. Initializes a new instance of the UnregisterAssembly class.

Properties

Assemblies	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the assemblies to be unregistered.
AssemblyListFile	This API supports the product infrastructure and is not intended to be used directly from your code. The cache file for Register/UnregisterAssembly. Necessary for UnregisterAssembly to do the proper clean up.
BuildEngine	The build engine automatically sets this property to allow tasks to call back into it. (Inherited from AppDomainIsolatedTask)
HelpKeywordPrefix	Gets or sets the prefix used to compose help keywords from string resource names. If a task does not have help keywords associated with its messages, it can ignore this property or set it to null. If the prefix is set to an empty string, then string resource names will be used verbatim as help keywords. For an example of how this prefix is used, see the LogErrorWithCodeFromResources(String, Object[]) method. (Inherited from AppDomainIsolatedTask)
HostObject	The build engine sets this property if the host IDE has associated a host object with this particular task. (Inherited from AppDomainIsolatedTask)
Log	This API supports the product infrastructure and is not intended to be used directly from your code. Gets an instance of a TaskLoggingHelperExtension class containing task logging methods. (Inherited from AppDomainIsolatedTaskExtension)
TaskResources	Gets or sets the task's culture-specific resources. Derived classes should register their resources either during construction, or via this property, if they have localized strings. (Inherited from AppDomainIsolatedTask)
TypeLibFiles	This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets a Boolean value that specifies whether to unregister the specified type library from the specified assembly.

Methods

Execute()	This API supports the product infrastructure and is not intended to be used directly from your code. Task entry point
InitializeLifetimeService()	Overridden to give tasks deriving from this class infinite lease time. Otherwise we end up with a limited lease (5 minutes I think) and task instances can expire if they take long time processing. (Inherited from AppDomainIsolatedTask)