Compartilhar via


-platform (Visual Basic)

Especifica qual versão de plataforma do CLR (Common Language Runtime) pode executar o arquivo de saída.

Sintaxe

-platform:{ x86 | x64 | Itanium | arm | anycpu | anycpu32bitpreferred }  

Argumentos

Prazo Definição
x86 Compila o assembly a ser executado pelo CLR compatível com x86 de 32 bits.
x64 Compila o assembly a ser executado pelo CLR de 64 bits em um computador que dá suporte ao conjunto de instruções AMD64 ou EM64T.
Itanium Compila o assembly a ser executado pelo CLR de 64 bits em um computador com um processador Itanium.
arm Compila o assembly a ser executado em um computador com um processador ARM (Advanced RISC Machine).
anycpu Compila o assembly a ser executado em qualquer plataforma. O aplicativo será executado como um aplicativo de 32 bits em versões de 32 bits do Windows e como um aplicativo de 64 bits em versões de 64 bits do Windows. Esse sinalizador é o valor padrão.
anycpu32bitpreferred Compila o assembly a ser executado em qualquer plataforma. O aplicativo será executado como um aplicativo de 32 bits em versões de 32 bits e 64 bits do Windows. Esse sinalizador é válido apenas para executáveis (.EXE) e requer o .NET Framework 4.5.

Observações

Use a opção -platform para especificar o tipo de processador direcionado pelo arquivo de saída.

Em geral, os assemblies do .NET Framework escritos no Visual Basic serão executados da mesma maneira, independentemente da plataforma. No entanto, há alguns casos que se comportam de forma diferente em diferentes plataformas. Esses casos comuns são:

  • Estruturas que contêm membros que alteram o tamanho dependendo da plataforma, como qualquer tipo de ponteiro.

  • Aritmética de ponteiro que inclui tamanhos constantes.

  • As declarações COM ou de invocação de plataforma incorreta que usam Integer para identificadores em vez de IntPtr.

  • Lançando IntPtr para Integer.

  • Usando a invocação de plataforma ou interoperabilidade COM com componentes que não existem em todas as plataformas.

A opção -platform atenuará alguns problemas se você souber que fez suposições sobre a arquitetura em que seu código será executado. Especificamente:

  • Se você decidir direcionar uma plataforma de 64 bits e o aplicativo for executado em um computador de 32 bits, a mensagem de erro será muito mais anterior e será mais direcionada ao problema do que o erro que ocorre sem usar essa opção.

  • Se você definir o x86 sinalizador na opção e o aplicativo for executado posteriormente em um computador de 64 bits, o aplicativo será executado no subsistema WOW em vez de ser executado nativamente.

Em um sistema operacional do Windows de 64 bits:

  • Os assemblies compilados com -platform:x86 serão executados no CLR de 32 bits em execução em WOW64.

  • Executáveis compilados com o -platform:anycpu will execute no CLR de 64 bits.

  • Uma DLL compilada com a -platform:anycpu executará no mesmo CLR que o processo no qual ele carregou.

  • Os executáveis com -platform:anycpu32bitpreferred os quais são compilados serão executados no CLR de 32 bits.

Para obter mais informações sobre como desenvolver um aplicativo para ser executado em uma versão de 64 bits do Windows, consulte Aplicativos de 64 bits.

Para definir -platform no IDE do Visual Studio

  1. No Gerenciador de Soluções, escolha o projeto, abra o menu Projeto e clique em Propriedades.

  2. Na guia Compilar , marque ou desmarque a caixa de seleção Preferir de 32 bits ou, na lista de CPU de destino, escolha um valor.

    Para obter mais informações, consulte Página Compilar, Designer de Projeto (Visual Basic).

Exemplo

O exemplo a seguir ilustra como usar a opção do -platform compilador.

vbc -platform:x86 myFile.vb  

Consulte também