This topic has not yet been rated - Rate this topic

RegistrationServices Class

Provides a set of services for registering and unregistering managed assemblies for use from COM.

System.Object
  System.Runtime.InteropServices.RegistrationServices

Namespace:  System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)
[GuidAttribute("475E398F-8AFA-43a7-A3BE-F4EF8D6787C9")]
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.None)]
public class RegistrationServices : IRegistrationServices

The RegistrationServices type exposes the following members.

  Name Description
Public method RegistrationServices Initializes a new instance of the RegistrationServices class.
Top
  Name Description
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetManagedCategoryGuid Returns the GUID of the COM category that contains the managed classes.
Public method GetProgIdForType Retrieves the COM ProgID for the specified type.
Public method GetRegistrableTypesInAssembly Retrieves a list of classes in an assembly that would be registered by a call to RegisterAssembly.
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method RegisterAssembly Registers the classes in a managed assembly to enable creation from COM.
Public method RegisterTypeForComClients(Type, Guid) Registers the specified type with COM using the specified GUID.
Public method RegisterTypeForComClients(Type, RegistrationClassContext, RegistrationConnectionType) Registers the specified type with COM using the specified execution context and connection type.
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Public method TypeRepresentsComType Indicates whether a type is marked with the ComImportAttribute, or derives from a type marked with the ComImportAttribute and shares the same GUID as the parent.
Public method TypeRequiresRegistration Determines whether the specified type requires registration.
Public method UnregisterAssembly Unregisters the classes in a managed assembly.
Public method UnregisterTypeForComClients Removes references to a type registered with the RegisterTypeForComClients method.
Top

Registration is needed when the objects within an assembly are being used by COM clients. The Regasm.exe (Assembly Registration Tool) and Microsoft Visual Studio 2005 use methods exposed by the RegistrationServices class to add or remove COM-enabling registry entries for managed assemblies.

You can use the following methods to assist you in preparing a registration file:

Although these methods help in gathering information to be used in a registration file, they do not actually produce a registration file. Instead, you can use the Regasm.exe (Assembly Registration Tool) tool with the /regfile option to perform this task. RegistrationServices methods cannot export and register a type library. To export and register a type library, you can use the Regasm.exe (Assembly Registration Tool) tool and the Tlbexp.exe (Type Library Exporter) tool.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ