Compartir a través de

Método TypeLibConverter.ConvertTypeLibToAssembly (Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version)

  • Artículo

 

Publicado: octubre de 2016

Convierte una biblioteca de tipos COM en un ensamblado.

Espacio de nombres:   System.Runtime.InteropServices
Ensamblado:  mscorlib (en mscorlib.dll)

Sintaxis

[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
)

public:
[SecurityPermissionAttribute(SecurityAction::Demand, Flags = SecurityPermissionFlag::UnmanagedCode)]
virtual AssemblyBuilder^ ConvertTypeLibToAssembly(
    Object^ typeLib,
    String^ asmFileName,
    TypeLibImporterFlags flags,
    ITypeLibImporterNotifySink^ notifySink,
    array<unsigned char>^ publicKey,
    StrongNameKeyPair^ keyPair,
    String^ asmNamespace,
    Version^ asmVersion
) sealed

[<SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)>]
abstract ConvertTypeLibToAssembly : 
        typeLib:Object *
        asmFileName:string *
        flags:TypeLibImporterFlags *
        notifySink:ITypeLibImporterNotifySink *
        publicKey:byte[] *
        keyPair:StrongNameKeyPair *
        asmNamespace:string *
        asmVersion:Version -> AssemblyBuilder
[<SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)>]
override ConvertTypeLibToAssembly : 
        typeLib:Object *
        asmFileName:string *
        flags:TypeLibImporterFlags *
        notifySink:ITypeLibImporterNotifySink *
        publicKey:byte[] *
        keyPair:StrongNameKeyPair *
        asmNamespace:string *
        asmVersion:Version -> AssemblyBuilder

<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.UnmanagedCode)>
Public Function ConvertTypeLibToAssembly (
    typeLib As Object,
    asmFileName As String,
    flags As TypeLibImporterFlags,
    notifySink As ITypeLibImporterNotifySink,
    publicKey As Byte(),
    keyPair As StrongNameKeyPair,
    asmNamespace As String,
    asmVersion As Version
) As AssemblyBuilder

Parámetros

  • typeLib
    Type: System.Object

    Objeto que implementa la interfaz ITypeLib.

  • asmFileName
    Type: System.String

    El nombre de archivo del ensamblado resultante.

  • publicKey
    Type: System.Byte[]

    Un byte matriz que contiene la clave pública.

  • asmNamespace
    Type: System.String

    El espacio de nombres para el ensamblado resultante.

  • asmVersion
    Type: System.Version

    La versión del ensamblado resultante. Si null, se utiliza la versión de la biblioteca de tipos.

Valor devuelto

Type: System.Reflection.Emit.AssemblyBuilder

Un AssemblyBuilder objeto que contiene la biblioteca de tipos convertidos.

Implementa

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

Excepciones

Exception Condition
ArgumentNullException

El valor de typeLib es null.

O bien

El valor de asmFileName es null.

O bien

El valor de notifySink es null.
ArgumentException

asmFileName es una cadena vacía.

O bien

asmFileName es mayor que MAX_PATH.
InvalidOperationException

flags no es PrimaryInteropAssembly.

O bien

publicKey y keyPair son null.
ReflectionTypeLoadException

Los metadatos producidos tienen errores que impiden que los tipos de carga.

Comentarios

Si no desea generar un nombre seguro para el ensamblado, es válido para publicKey y keyPair se null, siempre que flags no es igual a TypeLibImporterFlags.PrimaryInteropAssembly. De lo contrario, se debe especificar al menos uno de estos parámetros. Si publicKey es null, la clave pública en keyPair se establecerá en los metadatos del manifiesto del ensamblado de destino y se generará una firma basada en el contenido del ensamblado. Si keyPair es null, publicKey se establecerá en los metadatos del manifiesto del ensamblado de destino y no se generará ninguna firma. Especificar los dos parámetros no suele ser útil y puede dar lugar a una firma no válida.

Para obtener más información sobre ITypeLib, consulte la documentación correspondiente en MSDN library.

Ejemplos

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; 
    }   
}

Imports System
Imports System.Reflection
Imports System.Reflection.Emit
Imports System.Runtime.InteropServices

Public Class App
    Private Enum RegKind
        RegKind_Default = 0
        RegKind_Register = 1
        RegKind_None = 2
    End Enum 'RegKind

    <DllImport("oleaut32.dll", CharSet:=CharSet.Unicode, PreserveSig:=False)> _
    Private Shared Sub LoadTypeLibEx(ByVal strTypeLibName As [String], ByVal regKind As RegKind, <MarshalAs(UnmanagedType.Interface)> ByRef typeLib As [Object])
    End Sub

    Public Shared Sub Main()
        Dim typeLib As [Object]
        LoadTypeLibEx("SHDocVw.dll", RegKind.RegKind_None, typeLib)

        If typeLib Is Nothing Then
            Console.WriteLine("LoadTypeLibEx failed.")
            Return
        End If

        Dim converter As New TypeLibConverter()
        Dim eventHandler As New ConversionEventHandler()
        Dim asm As AssemblyBuilder = converter.ConvertTypeLibToAssembly(typeLib, "ExplorerLib.dll", 0, eventHandler, Nothing, Nothing, Nothing, Nothing)
        asm.Save("ExplorerLib.dll")
    End Sub 'Main
End Class 'App
 _

Public Class ConversionEventHandler
    Implements ITypeLibImporterNotifySink

    Public Sub ReportEvent(ByVal eventKind As ImporterEventKind, ByVal eventCode As Integer, ByVal eventMsg As String) Implements ITypeLibImporterNotifySink.ReportEvent
        ' handle warning event here...
    End Sub 'ReportEvent

    Public Function ResolveRef(ByVal typeLib As Object) As [Assembly] Implements ITypeLibImporterNotifySink.ResolveRef
        ' resolve reference here and return a correct assembly...
        Return Nothing
    End Function 'ResolveRef
End Class 'ConversionEventHandler

using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
using namespace System::Runtime::InteropServices;

enum class RegKind
{
   RegKind_Default, RegKind_Register, RegKind_None
};

ref class ConversionEventHandler: public ITypeLibImporterNotifySink
{
public:
   virtual void ReportEvent( ImporterEventKind eventKind, int eventCode, String^ eventMsg )
   {

      // handle warning event here...
   }

   virtual Assembly^ ResolveRef( Object^ typeLib )
   {

      // resolve reference here and return a correct assembly...
      return nullptr;
   }

};


[DllImport("oleaut32.dll",CharSet=CharSet::Unicode,PreserveSig=false)]
extern void LoadTypeLibEx( String^ strTypeLibName, RegKind regkind,
         [MarshalAs(UnmanagedType::Interface)] interior_ptr<Object^> typeLib );

int main()
{
   Object^ typeLib = gcnew Object;
   LoadTypeLibEx( "SHDocVw.dll", RegKind::RegKind_None,  &typeLib );
   if ( typeLib == nullptr )
   {
      Console::WriteLine( "LoadTypeLibEx failed." );
      return 0;
   }

   TypeLibConverter^ converter = gcnew TypeLibConverter;
   ConversionEventHandler^ eventHandler = gcnew ConversionEventHandler;
   AssemblyBuilder^ asmb = converter->ConvertTypeLibToAssembly( typeLib, "ExplorerLib.dll", (System::Runtime::InteropServices::TypeLibImporterFlags)0, eventHandler, nullptr, nullptr, nullptr, nullptr );
   asmb->Save( "ExplorerLib.dll" );
}

Seguridad

SecurityPermission

for permission to call unmanaged code.

Security Action: Demand.

Associated Enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

Información de versión

.NET Framework
Disponible desde 1.1

Ver también

ConvertTypeLibToAssembly Sobrecarga
Clase TypeLibConverter
Espacio de nombres System.Runtime.InteropServices
Atributos para importar bibliotecas de tipos en ensamblados de interoperabilidad

Volver al principio