TypeLibConverter.ConvertTypeLibToAssembly Method (Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version)


Converts a COM type library to an assembly.

Namespace:   System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public AssemblyBuilder ConvertTypeLibToAssembly(
	object typeLib,
	string asmFileName,
	TypeLibImporterFlags flags,
	ITypeLibImporterNotifySink notifySink,
	byte[] publicKey,
	StrongNameKeyPair keyPair,
	string asmNamespace,
	Version asmVersion


Type: System.Object

The object that implements the ITypeLib interface.

Type: System.String

The file name of the resulting assembly.

Type: System.Runtime.InteropServices.TypeLibImporterFlags

A TypeLibImporterFlags value indicating any special settings.

Type: System.Runtime.InteropServices.ITypeLibImporterNotifySink

ITypeLibImporterNotifySink interface implemented by the caller.

Type: System.Byte[]

A byte array containing the public key.

Type: System.Reflection.StrongNameKeyPair

A StrongNameKeyPair object containing the public and private cryptographic key pair.

Type: System.String

The namespace for the resulting assembly.

Type: System.Version

The version of the resulting assembly. If null, the version of the type library is used.

Return Value

Type: System.Reflection.Emit.AssemblyBuilder

An AssemblyBuilder object containing the converted type library.

Exception Condition

typeLib is null.


asmFileName is null.


notifySink is null.


asmFileName is an empty string.


asmFileName is longer than MAX_PATH.


flags is not PrimaryInteropAssembly.


publicKey and keyPair are null.


The metadata produced has errors preventing any types from loading.

If you do not want to generate a strong name for your assembly, it is valid for publicKey and keyPair to be null, as long as flags does not equal TypeLibImporterFlags.PrimaryInteropAssembly. Otherwise, atleast one of these parameters must be specified. If publicKey is null, the public key in keyPair will be set in the target assembly's manifest metadata and a signature will be generated based on the contents of the assembly. If keyPair is null, publicKey will be set in the target assembly's manifest metadata and no signature will be generated. Specifying both parameters is not generally useful, and can result in an invalid signature.

For more information on ITypeLib, please see its existing documentation in the MSDN library.

using System;
using System.Reflection;
using System.Reflection.Emit;
using System.Runtime.InteropServices;

public class App
	private enum RegKind
		RegKind_Default = 0,
		RegKind_Register = 1,
		RegKind_None = 2

	[ DllImport( "oleaut32.dll", CharSet = CharSet.Unicode, PreserveSig = false )]
	private static extern void LoadTypeLibEx( String strTypeLibName, RegKind regKind, 
		[ MarshalAs( UnmanagedType.Interface )] out Object typeLib );

	public static void Main()
		Object typeLib;
		LoadTypeLibEx( "SHDocVw.dll", RegKind.RegKind_None, out typeLib ); 

		if( typeLib == null )
			Console.WriteLine( "LoadTypeLibEx failed." );

		TypeLibConverter converter = new TypeLibConverter();
		ConversionEventHandler eventHandler = new ConversionEventHandler();
		AssemblyBuilder asm = converter.ConvertTypeLibToAssembly( typeLib, "ExplorerLib.dll", 0, eventHandler, null, null, null, null );	
		asm.Save( "ExplorerLib.dll" );

public class ConversionEventHandler : ITypeLibImporterNotifySink
	public void ReportEvent( ImporterEventKind eventKind, int eventCode, string eventMsg )
		// handle warning event here...

	public Assembly ResolveRef( object typeLib )
		// resolve reference here and return a correct assembly...
		return null; 


for permission to call unmanaged code.

Security Action: Demand.

Associated Enumeration: UnmanagedCode

.NET Framework
Available since 1.1
Return to top