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

Artículo
04/18/2017

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,
    int flags,
    ITypeLibImporterNotifySink notifySink,
    byte[] publicKey,
    StrongNameKeyPair keyPair,
    bool unsafeInterfaces
)

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

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

<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.UnmanagedCode)>
Public Function ConvertTypeLibToAssembly (
    typeLib As Object,
    asmFileName As String,
    flags As Integer,
    notifySink As ITypeLibImporterNotifySink,
    publicKey As Byte(),
    keyPair As StrongNameKeyPair,
    unsafeInterfaces As Boolean
) 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.

flags
Type: System.Int32

Un TypeLibImporterFlags valor que indica cualquier configuración especial.

notifySink
Type: System.Runtime.InteropServices.ITypeLibImporterNotifySink

ITypeLibImporterNotifySink interfaz implementada por el llamador.

publicKey
Type: System.Byte[]

Un byte matriz que contiene la clave pública.

keyPair
Type: System.Reflection.StrongNameKeyPair

Un StrongNameKeyPair objeto que contiene el par de claves criptográficas público y privado.

unsafeInterfaces
Type: System.Boolean

Si true, las interfaces necesitan comprobaciones en tiempo de vínculo de UnmanagedCode permiso. Si false, las interfaces necesitan comprobaciones en tiempo de ejecución que requieren una pila recorren y son más caros, pero ayuda a proporcionar una mayor protección.

Valor devuelto

Type: System.Reflection.Emit.AssemblyBuilder

Un AssemblyBuilder objeto que contiene la biblioteca de tipos convertidos.

Implementa

ITypeLibConverter.ConvertTypeLibToAssembly(Object, String, Int32, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, Boolean)

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, al menos uno de estos parámetros debe especificarse. 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.

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

Compartir a través de