TypeLibConverter.ConvertTypeLibToAssembly Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Converteert een COM-typebibliotheek naar een assembly.
Overloads
| Name | Description |
|---|---|
| ConvertTypeLibToAssembly(Object, String, Int32, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, Boolean) |
Converteert een COM-typebibliotheek naar een assembly. |
| ConvertTypeLibToAssembly(Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version) |
Converteert een COM-typebibliotheek naar een assembly. |
ConvertTypeLibToAssembly(Object, String, Int32, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, Boolean)
Converteert een COM-typebibliotheek naar een assembly.
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
Parameters
- typeLib
- Object
Het object dat de ITypeLib interface implementeert.
- asmFileName
- String
De bestandsnaam van de resulterende assembly.
- flags
- Int32
Een TypeLibImporterFlags waarde die eventuele speciale instellingen aangeeft.
- notifySink
- ITypeLibImporterNotifySink
ITypeLibImporterNotifySink interface geïmplementeerd door de beller.
- publicKey
- Byte[]
Een byte matrix met de openbare sleutel.
- keyPair
- StrongNameKeyPair
Een StrongNameKeyPair object met het openbare en persoonlijke cryptografische sleutelpaar.
- unsafeInterfaces
- Boolean
Als truevoor de interfaces een koppelingstijd is vereist, wordt gecontroleerd op UnmanagedCode machtigingen. Als falsevoor de interfaces runtimecontroles zijn vereist die een stack-wandeling vereisen en duurder zijn, maar u kunt beter beveiligen.
Retouren
Een AssemblyBuilder object met de geconverteerde typebibliotheek.
Implementeringen
Uitzonderingen
asmFileName is een lege tekenreeks.
– of –
asmFileName is langer dan de door het systeem gedefinieerde maximumlengte. Zie PathTooLongException voor meer informatie.
De gegenereerde metagegevens bevatten fouten waardoor typen niet kunnen worden geladen.
Opmerkingen
Als u geen sterke naam voor uw assembly wilt genereren, is deze geldig voor publicKey en te zijnkeyPair, zolang null deze niet gelijk is flagsTypeLibImporterFlags.PrimaryInteropAssembly aan . Anders moet ten minste één van deze parameters worden opgegeven. Als publicKey dat het is null, wordt de openbare sleutel keyPair ingesteld in de manifestmetagegevens van de doelassembly en wordt er een handtekening gegenereerd op basis van de inhoud van de assembly. Als keyPair dat het is null, publicKey wordt ingesteld in de manifestmetagegevens van de doelassembly en wordt er geen handtekening gegenereerd. Het opgeven van beide parameters is over het algemeen niet nuttig en kan resulteren in een ongeldige handtekening.
Zie de bestaande documentatie in de MSDN-bibliotheek voor meer informatie ITypeLib.
Van toepassing op
ConvertTypeLibToAssembly(Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version)
Converteert een COM-typebibliotheek naar een assembly.
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
Parameters
- typeLib
- Object
Het object dat de ITypeLib interface implementeert.
- asmFileName
- String
De bestandsnaam van de resulterende assembly.
- flags
- TypeLibImporterFlags
Een TypeLibImporterFlags waarde die eventuele speciale instellingen aangeeft.
- notifySink
- ITypeLibImporterNotifySink
ITypeLibImporterNotifySink interface geïmplementeerd door de beller.
- publicKey
- Byte[]
Een byte matrix met de openbare sleutel.
- keyPair
- StrongNameKeyPair
Een StrongNameKeyPair object met het openbare en persoonlijke cryptografische sleutelpaar.
- asmNamespace
- String
De naamruimte voor de resulterende assembly.
- asmVersion
- Version
De versie van de resulterende assembly. Als null, de versie van de typebibliotheek wordt gebruikt.
Retouren
Een AssemblyBuilder object met de geconverteerde typebibliotheek.
Implementeringen
Uitzonderingen
asmFileName is een lege tekenreeks.
– of –
asmFileName is langer dan de door het systeem gedefinieerde maximumlengte. Zie PathTooLongException voor meer informatie.
De gegenereerde metagegevens bevatten fouten waardoor typen niet kunnen worden geladen.
Voorbeelden
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
Opmerkingen
Als u geen sterke naam voor uw assembly wilt genereren, is deze geldig voor publicKey en te zijnkeyPair, zolang null deze niet gelijk is flagsTypeLibImporterFlags.PrimaryInteropAssembly aan . Anders moet een van deze parameters ten minste worden opgegeven. Als publicKey dat het is null, wordt de openbare sleutel keyPair ingesteld in de manifestmetagegevens van de doelassembly en wordt er een handtekening gegenereerd op basis van de inhoud van de assembly. Als keyPair dat het is null, publicKey wordt ingesteld in de manifestmetagegevens van de doelassembly en wordt er geen handtekening gegenereerd. Het opgeven van beide parameters is over het algemeen niet nuttig en kan resulteren in een ongeldige handtekening.
Zie de bestaande documentatie in de MSDN-bibliotheek voor meer informatie ITypeLib.