Importador de controle ActiveX do Windows Forms (aximp.exe)
O importador do controle ActiveX converte definições de tipo em uma biblioteca de tipos COM para um controle ActiveX em um controle Windows Forms.
Windows Forms podem apenas host Windows Forms controles — ou seja, as classes derivadas de Control. Aximp.exe gera uma classe wrapper para um controle ActiveX que pode ser hospedado em um Windows formulário. Isso permite que você usar o mesmo suporte em time de design e a metodologia programação aplicável a outros controles Windows Forms.
Para hospedar o controle ActiveX, você deve gerar um wrapper controle que deriva de AxHost. Esse controle wrapper contém uma instância do controle ActiveX subjacente. Ele sabe sistema autônomo se comunicar com o controle ActiveX, mas ele aparece sistema autônomo um controle Windows Forms. Este controle gerado hospeda o controle ActiveX e expõe suas propriedades, métodos e eventos que sistema autônomo do controle gerado.
aximp [options]{file.dll | file.ocx}
Comentários
Argumento |
Descrição |
|---|---|
file |
O nome do arquivo de fonte que contém o controle ActiveX para converter. O argumento do arquivo deve ter a extensão .dll ou .ocx. |
Opção |
Descrição |
|---|---|
/delaysign |
Especifica a aximp.exe para assinar o controle resultante usando a assinatura atrasada. Você deve especificar essa opção com ambos o /keycontainer:, /keyfile:, or /publickey: opção. Para obter mais informações sobre o processo de assinatura atrasada, consulte Atraso na Assinatura de um Assembly. |
/help |
Exibe sintaxe de comando e opções para a ferramenta. |
/keycontainer:containerName |
Sinais o controle resultante com um nome forte usando o emparelhar de chaves pública/particular encontrado no contêiner de chave especificado por containerName. |
/keyfile:nome do arquivo de |
O controle resultante com um nome forte usando oficial emparelhar de chaves pública/particular do publicador de sinais encontrado no nome de arquivo. |
/nologo |
Suprime a exibição Microsoft faixa de inicialização. |
/out:nome do arquivo de |
Especifica o nome do assembly para criar. |
/publickey:nome do arquivo de |
O controle resultante com um nome forte usando a chave pública de sinais encontrado no arquivo especificado por nome de arquivo. |
/ silencioso |
Suprime a exibição das mensagens de êxito. |
/fonte |
Gera código-fonte translation from VPE for Csharp wrapper Windows Forms. |
/verbose |
Especifica o modo detalhado; exibe informações sobre o andamento adicionais. |
/? |
Exibe sintaxe de comando e opções para a ferramenta. |
Aximp.exe converte uma biblioteca inteira de tipo de controle ActiveX de uma só vez e produz um conjunto de módulos (assemblies) que contêm o Common Language tempo de execução implementação metadados e controlar para os tipos definidos na biblioteca de tipos originais. Os arquivos gerados são nomeados de acordo com o seguinte padrão:
proxy de tempo de execução de linguagem comum para tipos COM: ProgID.dll
Proxy de Windows Forms para controles ActiveX (onde AX significa ActiveX): AxProgID.dll
.gif "Observação") Observação: |
|---|
Se o nome de um membro do controle ActiveX coincidir com um nome definido no .NET estrutura, aximp.exe será prefixo o nome do membro com" CTL "quando cria o AxHost classe derivada. Por exemplo, se seu controle ActiveX tiver um membro chamado "Layout", ele é renomeado" CtlLayout "no AxHost classe derivada como o evento Layout é definido dentro do .NET estrutura |
Você pode examinar esses arquivos gerados com ferramentas sistema autônomo, por exemplo, Desassemblador do MSIL (ILDASM.exe).
Não há suporte para o uso de aximp.exe para gerar um assembly .NET para o controle ActiveX WebBrowser (shdocvw.dll).
Quando você executa aximp.exe sobre shdocvw.dll, ele sempre criará outro arquivo denominado shdocvw.dll na diretório do que a ferramenta é executada. Se esse arquivo gerado for colocado no diretório Documents and Settings, ele causa problemas para o Microsoft Internet Explorer e o Windows Explorer. Quando o computador for reinicializado, Windows procura no diretório Documents and Settings antes da pasta system32 para localizar uma cópia do shdocvw.dll. Ele irá usar a cópia que localiza no Documents and Settings e tente carregar invólucros gerenciado. Internet Explorer e no Windows Explorer não funcionará corretamente porque eles contar com o mecanismo de renderização na versão do shdocvw.dll localizado no diretório system32. Se esse problema ocorre, excluir a cópia do shdocvw.dll na pasta Documents and Settings e reinicialize o computador.
Usando aximp.exe com shdocvw.dll para criar um assembly .NET para uso no desenvolvimento de aplicativos também pode causar problemas. Nesse caso, seu aplicativo será carregada a versão de shdocvw.dll sistema e a versão gerada e pode fornecer a prioridade de versão do sistema. Nesse caso, quando você tentar carregar uma página da Web dentro do controle ActiveX do WebBrowser, os usuários podem ser solicitados com uma caixa de diálogo em em aberto/Salvar. Quando o usuário clica em aberto, na Web página será aberta no Internet Explorer. Isso ocorre apenas com computadores que executam o Internet Explorer versão 6 ou anterior. Para evitar esse problema, use o gerenciado WebBrowser controle ou o uso Visual Studio para gerar o shdocvw.dll gerenciado sistema autônomo descrito em Como: Adicionar referências a bibliotecas de tipo.
Exemplo
O comando a seguir gera MediaPlayer.dll e AxMediaPlayer.dll para o mídia Player controle msdxm.ocx.
aximp c:\systemroot\system32\msdxm.ocx