TypeLibConverter.ConvertTypeLibToAssembly 方法

定義

命名空間:: System.Runtime.InteropServices

組件:: mscorlib.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將 COM 型態函式庫轉換為組合語言。

多載

名稱	Description
ConvertTypeLibToAssembly(Object, String, Int32, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, Boolean)	將 COM 型態函式庫轉換為組合語言。
ConvertTypeLibToAssembly(Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version)	將 COM 型態函式庫轉換為組合語言。

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

將 COM 型態函式庫轉換為組合語言。

public:
 virtual System::Reflection::Emit::AssemblyBuilder ^ ConvertTypeLibToAssembly(System::Object ^ typeLib, System::String ^ asmFileName, int flags, System::Runtime::InteropServices::ITypeLibImporterNotifySink ^ notifySink, cli::array <System::Byte> ^ publicKey, System::Reflection::StrongNameKeyPair ^ keyPair, bool unsafeInterfaces);

public System.Reflection.Emit.AssemblyBuilder ConvertTypeLibToAssembly(object typeLib, string asmFileName, int flags, System.Runtime.InteropServices.ITypeLibImporterNotifySink notifySink, byte[] publicKey, System.Reflection.StrongNameKeyPair keyPair, bool unsafeInterfaces);

abstract member ConvertTypeLibToAssembly : obj * string * int * System.Runtime.InteropServices.ITypeLibImporterNotifySink * byte[] * System.Reflection.StrongNameKeyPair * bool -> System.Reflection.Emit.AssemblyBuilder
override this.ConvertTypeLibToAssembly : obj * string * int * System.Runtime.InteropServices.ITypeLibImporterNotifySink * byte[] * System.Reflection.StrongNameKeyPair * bool -> System.Reflection.Emit.AssemblyBuilder

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

參數

typeLib: Object

實作 ITypeLib 介面的物件。

asmFileName: String

產生的組裝檔名稱。

flags: Int32

一個 TypeLibImporterFlags 表示特殊設定的數值。

notifySink: ITypeLibImporterNotifySink

ITypeLibImporterNotifySink 由呼叫者實作的介面。

publicKey: Byte[]

一個 byte 包含公鑰的陣列。

keyPair: StrongNameKeyPair

包含 StrongNameKeyPair 公開與私密密碼金鑰對的物件。

unsafeInterfaces: Boolean

若 true，介面需進行連結時間檢查以取得 UnmanagedCode 權限。若 false，介面需要執行時檢查，需進行堆疊行走且成本較高，但有助於提供更佳的保護。

傳回

AssemblyBuilder

一個 AssemblyBuilder 包含轉換後型別庫的物件。

實作

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

例外狀況

ArgumentNullException

typeLib 是 null。

-或-

asmFileName 是 null。

-或-

notifySink 是 null。

ArgumentException

asmFileName 是空字串。

-或-

asmFileName 比系統定義的最大長度還要長。如需詳細資訊，請參閱PathTooLongException。

InvalidOperationException

flags 不是 PrimaryInteropAssembly。

-或-

publicKey 且 keyPair 是 null。

ReflectionTypeLoadException

產生的元資料存在錯誤，導致任何類型無法載入。

備註

如果你不想為你的組合產生強名稱，只要不等於，它對且成立 publicKey 。keyPairnullflagsTypeLibImporterFlags.PrimaryInteropAssembly 否則，至少必須指定其中一個參數。若 publicKey 是 null，公 keyPair 鑰將被設定在目標組裝的 manifest metadata 中，並根據組裝內容產生簽名。若 keyPair 是 null， publicKey 則會在目標組裝的清單元資料中被設定，且不會產生簽章。同時指定兩個參數通常沒什麼用，且可能導致簽章無效。

欲了解更多相關 ITypeLib資訊，請參閱 MSDN 圖書館中現有的文件。

適用於

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

將 COM 型態函式庫轉換為組合語言。

public:
 virtual System::Reflection::Emit::AssemblyBuilder ^ ConvertTypeLibToAssembly(System::Object ^ typeLib, System::String ^ asmFileName, System::Runtime::InteropServices::TypeLibImporterFlags flags, System::Runtime::InteropServices::ITypeLibImporterNotifySink ^ notifySink, cli::array <System::Byte> ^ publicKey, System::Reflection::StrongNameKeyPair ^ keyPair, System::String ^ asmNamespace, Version ^ asmVersion);

public System.Reflection.Emit.AssemblyBuilder ConvertTypeLibToAssembly(object typeLib, string asmFileName, System.Runtime.InteropServices.TypeLibImporterFlags flags, System.Runtime.InteropServices.ITypeLibImporterNotifySink notifySink, byte[] publicKey, System.Reflection.StrongNameKeyPair keyPair, string asmNamespace, Version asmVersion);

abstract member ConvertTypeLibToAssembly : obj * string * System.Runtime.InteropServices.TypeLibImporterFlags * System.Runtime.InteropServices.ITypeLibImporterNotifySink * byte[] * System.Reflection.StrongNameKeyPair * string * Version -> System.Reflection.Emit.AssemblyBuilder
override this.ConvertTypeLibToAssembly : obj * string * System.Runtime.InteropServices.TypeLibImporterFlags * System.Runtime.InteropServices.ITypeLibImporterNotifySink * byte[] * System.Reflection.StrongNameKeyPair * string * Version -> System.Reflection.Emit.AssemblyBuilder

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

參數

typeLib: Object

實作 ITypeLib 介面的物件。

asmFileName: String

產生的組裝檔名稱。

flags: TypeLibImporterFlags

一個 TypeLibImporterFlags 表示特殊設定的數值。

notifySink: ITypeLibImporterNotifySink

ITypeLibImporterNotifySink 由呼叫者實作的介面。

publicKey: Byte[]

一個 byte 包含公鑰的陣列。

keyPair: StrongNameKeyPair

包含 StrongNameKeyPair 公開與私密密碼金鑰對的物件。

asmNamespace: String

這是最終組裝的命名空間。

asmVersion: Version

這是最終組裝的版本。若 null，則使用型別庫的版本。

傳回

AssemblyBuilder

一個 AssemblyBuilder 包含轉換後型別庫的物件。

實作

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

例外狀況

ArgumentNullException

typeLib 是 null。

-或-

asmFileName 是 null。

-或-

notifySink 是 null。

ArgumentException

asmFileName 是空字串。

-或-

asmFileName 比系統定義的最大長度還要長。如需詳細資訊，請參閱PathTooLongException。

InvalidOperationException

flags 不是 PrimaryInteropAssembly。

-或-

publicKey 且 keyPair 是 null。

ReflectionTypeLoadException

產生的元資料存在錯誤，導致任何類型無法載入。

範例

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

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.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
End Class
 _

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

    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

備註

如果你不想為你的組合產生強名稱，只要不等於，它對且成立 publicKey 。keyPairnullflagsTypeLibImporterFlags.PrimaryInteropAssembly 否則，必須指定至少其中一個參數。若 publicKey 是 null，公 keyPair 鑰將被設定在目標組裝的 manifest metadata 中，並根據組裝內容產生簽名。若 keyPair 是 null， publicKey 則會在目標組裝的清單元資料中被設定，且不會產生簽章。同時指定兩個參數通常沒什麼用，且可能導致簽章無效。

欲了解更多相關 ITypeLib資訊，請參閱 MSDN 圖書館中現有的文件。

適用於

意見反應

此頁面對您有幫助嗎？