TypeLibConverter.ConvertTypeLibToAssembly-Methode: (Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version)

Artikel
04/20/2017

Veröffentlicht: Oktober 2016

Eine COM-Typbibliothek konvertiert in eine Assembly.

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

Syntax

[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

Parameter

typeLib
Type: System.Object

Das Objekt, das die ITypeLib-Schnittstelle implementiert.

asmFileName
Type: System.String

Der Dateiname der resultierenden Assembly.

flags
Type: System.Runtime.InteropServices.TypeLibImporterFlags

Ein TypeLibImporterFlags Wert, der alle speziellen Einstellungen.

notifySink
Type: System.Runtime.InteropServices.ITypeLibImporterNotifySink

ITypeLibImporterNotifySink vom Aufrufer implementierte Schnittstelle.

publicKey
Type: System.Byte[]

Ein byte Array, das den öffentlichen Schlüssel enthält.

keyPair
Type: System.Reflection.StrongNameKeyPair

Ein StrongNameKeyPair Objekt, das den öffentlichen und privaten kryptografischen Schlüsselpaar enthält.

asmNamespace
Type: System.String

Der Namespace für die resultierende Assembly.

asmVersion
Type: System.Version

Die Version der resultierenden Assembly. Wenn null, wird die Version der Typbibliothek verwendet.

Rückgabewert

Type: System.Reflection.Emit.AssemblyBuilder

Ein AssemblyBuilder -Objekt, das die konvertierte Typbibliothek enthält.

Implementiert

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

Ausnahmen

Exception	Condition
ArgumentNullException	typeLib ist null. - oder - asmFileName ist null. - oder - notifySink ist null.
ArgumentException	asmFileName ist eine leere Zeichenfolge. - oder - asmFileName ist länger als MAX_PATH.
InvalidOperationException	flags ist kein PrimaryInteropAssembly. - oder - publicKey und keyPair sind null.
ReflectionTypeLoadException	Die erstellten Metadaten enthalten Fehler, die beim Laden von Typen verhindern.

Hinweise

Wenn Sie nicht, zum Generieren eines starken Namens für die Assembly möchten ist ungültig für publicKey und keyPair werden null, solange flags ist nicht gleich TypeLibImporterFlags.PrimaryInteropAssembly. Andernfalls muss mindestens einer dieser Parameter angegeben werden. Wenn publicKey ist null, den öffentlichen Schlüssel in keyPair in den Metadaten des Manifests festgelegt und eine Signatur anhand des Inhalts der Assembly generiert. Wenn keyPair ist null, publicKey in den Metadaten des Manifests festgelegt und keine Signatur generiert werden. Angabe beider Parameter ist nicht in der Regel hilfreich, und kann dazu führen, dass eine ungültige Signatur.

Weitere Informationen zu ITypeLib, finden Sie unter der entsprechenden Dokumentation in der MSDN Library.

Beispiele

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

Sicherheit

SecurityPermission

for permission to call unmanaged code.

Security Action: Demand.

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

Versionsinformationen

.NET Framework
Verfügbar seit 1.1

Siehe auch

ConvertTypeLibToAssembly Überladen
TypeLibConverter-Klasse
System.Runtime.InteropServices-Namespace
Attribute für das Importieren von Typbibliotheken in Interop-Assemblys

Zurück zum Anfang

Freigeben über