Aximp. exe (Importador de controle de ActiveX do Windows Forms)
O importador de controle de ActiveX converte as definições de tipo em uma biblioteca de tipos COM para um controle ActiveX um controle Windows Forms.
Formulários do Windows só pode hospedar controles Windows Forms — ou seja, as classes derivadas de Control. Aximp. exe gera uma classe wrapper para um controle de ActiveX que pode ser hospedado em um Windows Form. Isso permite que você use o mesmo suporte de tempo de design e programação metodologia aplicável a outros controles Windows Forms.
Para hospedar o controle ActiveX, você deve gerar um controle de invólucro que deriva do AxHost. Esse controle de invólucro contém uma instância do controle base ActiveX. Ele sabe como se comunicar com o controle de ActiveX, mas ele aparece como um controle Windows Forms. Esse controle gerado hospede o controle de ActiveX e expõe suas propriedades, métodos e eventos, como aqueles do controle gerado.
aximp [options]{file.dll | file.ocx}
Comentários
Argumento |
Descrição |
|---|---|
file |
O nome do arquivo de origem que contém o controle de 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 um a /keycontainer:, /keyfile:, ou /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 |
Assina o controle resultante com um nome forte usando o par de chaves pública/particular encontrado no contêiner de chave especificado por containerName. |
/keyfile:nome de arquivo |
Assina o controle resultante com um nome forte usando oficial pública/privada par de chaves do publisher encontrados em nome de arquivo. |
/nologo |
Suprime a exibição Microsoft faixa de inicialização. |
/out:nome de arquivo |
Especifica o nome do assembly para criar. |
/publickey:nome de arquivo |
Assina o controle resultante com um nome forte usando a chave pública encontrada no arquivo especificado por nome de arquivo. |
/ silencioso |
Suprime a exibição de mensagens de sucesso. |
/Source |
Gera código fonte C# para o 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 de ActiveX de uma só vez e produz um conjunto de módulos (assemblies) que contêm os metadados de tempo de execução de linguagem comum e controlar a implementação para os tipos definidos na biblioteca de tipos original. 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 de ActiveX (onde Ax significa ActiveX): AXprogid. dll
Observação
Se o nome de um membro do controle ActiveX corresponde a um nome definido na.NET Framework, o aximp. exe será prefixar o nome do membro com "ctl" Quando ele cria a classe derivada de AxHost.Por exemplo, se o controle de ActiveX tem um membro chamado "Layout", ele é renomeado "ctllayout" na AxHost classe derivada porque o evento Layout é definido dentro do.NET Framework.
Você pode examinar esses arquivos gerados com ferramentas tais como Ildasm. exe (desmontador MSIL).
Usando o aximp. exe para gerar um.NET assembly para o controle de ActiveX WebBrowser (Shdocvw. dll) não é suportada.
Quando você executar o aximp. exe sobre Shdocvw. dll, ele sempre criará outro arquivo nomeado Shdocvw. dll no diretório no qual a ferramenta é executada. Se esse arquivo gerado é colocado no diretório Documents and Settings, ele causa problemas para Microsoft Internet Explorer e o Windows Explorer. Quando o computador for reinicializado, o Windows procura no diretório Documents and Settings antes o diretório system32 para localizar uma cópia de Shdocvw. dll. Ele usará a cópia, que ele localiza em Documents and Settings e tentar carregar os invólucros gerenciados. Internet Explorer e Windows Explorer não funcionará corretamente porque eles contam com o mecanismo de processamento na versão do Shdocvw. dll, localizado no diretório system32. Se esse problema ocorrer, exclua a cópia de Shdocvw. dll no diretório Documents and Settings e reinicializar o computador.
Usando o aximp. exe com Shdocvw. dll para criar um.NET assembly para uso no desenvolvimento de aplicativos também pode causar problemas. Nesse caso, o seu aplicativo será carregada a versão de Shdocvw. dll do sistema e da versão gerada e pode dar a prioridade de versão do sistema. Nesse caso, quando você tenta carregar uma página da Web dentro do controle WebBrowser ActiveX, os usuários podem ser solicitados com uma caixa de diálogo Abrir/Salvar. Quando o usuário clica Abrir, a página da Web será aberta no Internet Explorer. Isso ocorre somente com computadores que estejam executando o Internet Explorer versão 6 ou anterior. Para evitar esse problema, use o gerenciado WebBrowser controle ou use Visual Studio gerar o Shdocvw. dll gerenciado como descrito em Como: Adicionar referências a bibliotecas de tipo.
Exemplo
O comando a seguir gera MediaPlayer. dll e AxMediaPlayer.dll para o controle do Media Player msdxm.ocx.
aximp c:\systemroot\system32\msdxm.ocx
Consulte também
Referência
Ildasm. exe (desmontador MSIL)