RegisterAssembly Class

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

Implements the RegisterAssembly task. Use the RegisterAssembly element in your project file to create and execute this task. For usage and parameter information, see RegisterAssembly Task.

MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Inheritance Hierarchy

System.Object
  System.MarshalByRefObject
    Microsoft.Build.Utilities.AppDomainIsolatedTask
      Microsoft.Build.Tasks.AppDomainIsolatedTaskExtension
        Microsoft.Build.Tasks.RegisterAssembly

Namespace:  Microsoft.Build.Tasks
Assembly:  Microsoft.Build.Tasks.Core (in Microsoft.Build.Tasks.Core.dll)

Syntax

'Declaration
Public Class RegisterAssembly _
    Inherits AppDomainIsolatedTaskExtension _
    Implements ITypeLibExporterNotifySink
public class RegisterAssembly : AppDomainIsolatedTaskExtension, 
    ITypeLibExporterNotifySink
public ref class RegisterAssembly : public AppDomainIsolatedTaskExtension, 
    ITypeLibExporterNotifySink
type RegisterAssembly =  
    class 
        inherit AppDomainIsolatedTaskExtension 
        interface ITypeLibExporterNotifySink 
    end
public class RegisterAssembly extends AppDomainIsolatedTaskExtension implements ITypeLibExporterNotifySink

The RegisterAssembly type exposes the following members.

Constructors

  Name Description
Public method RegisterAssembly Infrastructure. Initializes a new instance of the RegisterAssembly class.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Top

Properties

  Name Description
Public property Assemblies Infrastructure. Gets or sets the assemblies to be registered with COM.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public property AssemblyListFile Infrastructure. Gets or sets information about the state between the RegisterAssembly task and the UnregisterAssembly task. This prevents the UnregisterAssembly task from attempting to unregister an assembly that failed to register in the RegisterAssembly task.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public property BuildEngine Gets or sets the build engine interface that is available to tasks.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from AppDomainIsolatedTask.)
Public property CreateCodeBase Infrastructure. Gets or sets a Boolean value that specifies whether the task creates a codebase entry in the registry, which specifies the file path for an assembly that is not installed in the global assembly cache. MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Protected property HelpKeywordPrefix Gets or sets the prefix that is used to compose Help keywords from string resource names.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from AppDomainIsolatedTask.)
Public property HostObject Gets or sets a host object instance that is associated with the derived Task.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from AppDomainIsolatedTask.)
Public property Log Infrastructure. Gets an instance of a TaskLoggingHelperExtension class containing task logging methods.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from AppDomainIsolatedTaskExtension.)
Protected property TaskResources Gets or sets culture-specific resources of the derived Task.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from AppDomainIsolatedTask.)
Public property TypeLibFiles Infrastructure. Gets or sets the type library to generate from the specified assembly.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Top

Methods

  Name Description
Public method CreateObjRef Security Critical. (Inherited from MarshalByRefObject.)
Public method Equals (Inherited from Object.)
Public method Execute Infrastructure. Executes the RegisterAssembly task.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Overrides AppDomainIsolatedTask.Execute().)
Protected method Finalize (Inherited from Object.)
Public method GetHashCode (Inherited from Object.)
Public method GetLifetimeService Security Critical. (Inherited from MarshalByRefObject.)
Public method GetType (Inherited from Object.)
Public method InitializeLifetimeService Security Critical. When overridden in a derived class, gives tasks infinite lease time.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from AppDomainIsolatedTask.)
Protected method MemberwiseClone() (Inherited from Object.)
Protected method MemberwiseClone(Boolean) (Inherited from MarshalByRefObject.)
Public method ReportEvent Infrastructure. Callback method for reporting the type library export events.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public method ResolveRef Infrastructure. Callback method for finding the type library for the specified assembly.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public method ToString (Inherited from Object.)

Top

Remarks

Framework64/<version>/RegisterAssemblyTask cannot resolve a library of COM objects registered as 32-bit components. Framework/<version>/RegisterAssemblyTask 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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.Build.Tasks Namespace