Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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.


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


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; 

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

© 2015 Microsoft