TypeLibConverter.ConvertTypeLibToAssembly Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte uma biblioteca de tipo COM em um assembly.
Sobrecargas
| ConvertTypeLibToAssembly(Object, String, Int32, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, Boolean) |
Converte uma biblioteca de tipo COM em um assembly. |
| ConvertTypeLibToAssembly(Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version) |
Converte uma biblioteca de tipo COM em um assembly. |
ConvertTypeLibToAssembly(Object, String, Int32, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, Boolean)
Converte uma biblioteca de tipo COM em um 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.AssemblyBuilderPublic Function ConvertTypeLibToAssembly (typeLib As Object, asmFileName As String, flags As Integer, notifySink As ITypeLibImporterNotifySink, publicKey As Byte(), keyPair As StrongNameKeyPair, unsafeInterfaces As Boolean) As AssemblyBuilderParâmetros
- typeLib
- Object
O objeto que implementa a interface do ITypeLib.
- asmFileName
- String
O nome do arquivo do assembly resultante.
- flags
- Int32
Um valor TypeLibImporterFlags que indica qualquer configuração especial.
- notifySink
- ITypeLibImporterNotifySink
A interface ITypeLibImporterNotifySink implementada pelo chamador.
- publicKey
- Byte[]
Uma matriz byte que contém a chave pública.
- keyPair
- StrongNameKeyPair
Um objeto StrongNameKeyPair que contém o par de chaves de criptografia públicas e privadas.
- unsafeInterfaces
- Boolean
Se true, as interfaces exigirão verificações de tempo de vinculação para a permissão UnmanagedCode. Se false, as interfaces exigirão verificações de tempo de execução que exigem percorrer uma pilha e são mais caras, mas ajudam a dar maior proteção.
Retornos
Um objeto AssemblyBuilder que contém a biblioteca de tipos convertida.
Implementações
Exceções
asmFileName é uma cadeia de caracteres vazia.
- ou -
asmFileName é maior que o comprimento máximo definido pelo sistema. Para obter mais informações, consulte PathTooLongException.
Os metadados produzido têm erros que impedem o carregamento de qualquer tipo.
Comentários
Se você não quiser gerar um nome forte para o assembly, ele será válido para publicKey e keyPair será , desde flags que não seja igual TypeLibImporterFlags.PrimaryInteropAssemblya null. Caso contrário, pelo menos um desses parâmetros deve ser especificado. Se publicKey for null, a chave pública em keyPair será definida nos metadados de manifesto do assembly de destino e uma assinatura será gerada com base no conteúdo do assembly. Se keyPair for null, publicKey será definido nos metadados de manifesto do assembly de destino e nenhuma assinatura será gerada. Especificar ambos os parâmetros geralmente não é útil e pode resultar em uma assinatura inválida.
Para obter mais informações sobre ITypeLib, consulte sua documentação existente na biblioteca MSDN.
Aplica-se a
ConvertTypeLibToAssembly(Object, String, TypeLibImporterFlags, ITypeLibImporterNotifySink, Byte[], StrongNameKeyPair, String, Version)
Converte uma biblioteca de tipo COM em um 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.AssemblyBuilderPublic 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 AssemblyBuilderParâmetros
- typeLib
- Object
O objeto que implementa a interface do ITypeLib.
- asmFileName
- String
O nome do arquivo do assembly resultante.
- flags
- TypeLibImporterFlags
Um valor TypeLibImporterFlags que indica qualquer configuração especial.
- notifySink
- ITypeLibImporterNotifySink
A interface ITypeLibImporterNotifySink implementada pelo chamador.
- publicKey
- Byte[]
Uma matriz byte que contém a chave pública.
- keyPair
- StrongNameKeyPair
Um objeto StrongNameKeyPair que contém o par de chaves de criptografia públicas e privadas.
- asmNamespace
- String
O namespace do assembly resultante.
- asmVersion
- Version
A versão do assembly resultante. Se null, a versão da biblioteca de tipos será usada.
Retornos
Um objeto AssemblyBuilder que contém a biblioteca de tipos convertida.
Implementações
Exceções
asmFileName é uma cadeia de caracteres vazia.
- ou -
asmFileName é maior que o comprimento máximo definido pelo sistema. Para obter mais informações, consulte PathTooLongException.
Os metadados produzido têm erros que impedem o carregamento de qualquer tipo.
Exemplos
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
Comentários
Se você não quiser gerar um nome forte para o assembly, ele será válido para publicKey e keyPair será , desde flags que não seja igual TypeLibImporterFlags.PrimaryInteropAssemblya null. Caso contrário, um desses parâmetros deve ser especificado. Se publicKey for null, a chave pública em keyPair será definida nos metadados de manifesto do assembly de destino e uma assinatura será gerada com base no conteúdo do assembly. Se keyPair for null, publicKey será definido nos metadados de manifesto do assembly de destino e nenhuma assinatura será gerada. Especificar ambos os parâmetros geralmente não é útil e pode resultar em uma assinatura inválida.
Para obter mais informações sobre ITypeLib, consulte sua documentação existente na biblioteca MSDN.
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de