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
)

Parameters

typeLib
Type: System.Object

The object that implements the ITypeLib interface.

asmFileName
Type: System.String

The file name of the resulting assembly.

flags
Type: System.Runtime.InteropServices.TypeLibImporterFlags

A TypeLibImporterFlags value indicating any special settings.

notifySink
Type: System.Runtime.InteropServices.ITypeLibImporterNotifySink

ITypeLibImporterNotifySink interface implemented by the caller.

publicKey
Type: System.Byte[]

A byte array containing the public key.

keyPair
Type: System.Reflection.StrongNameKeyPair

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

asmNamespace
Type: System.String

The namespace for the resulting assembly.

asmVersion
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.

Implements

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

ExceptionCondition
ArgumentNullException

typeLib is null.

-or-

asmFileName is null.

-or-

notifySink is null.

ArgumentException

asmFileName is an empty string.

-or-

asmFileName is longer than MAX_PATH.

InvalidOperationException

flags is not PrimaryInteropAssembly.

-or-

publicKey and keyPair are null.

ReflectionTypeLoadException

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." );
			return;
		}
			
		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.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft