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)

Outros recursos

Ferramentas.NET Framework