Página de compilação, Project Designer (Visual Basic)
Observação
Esta página refere-se à experiência do Project Designer no Visual Studio 2019 e para projetos do .NET Framework com o Visual Studio 2022.
Use a página Compile do Project Designer para especificar instruções de compilação. Você também pode especificar opções avançadas do compilador e eventos de pré-compilação ou pós-compilação nesta página.
Para acessar a página Compile, escolha um nó do projeto (não o nó Solution) no Gerenciador de Soluções . Em seguida, escolha Project, Properties na barra de menus. Quando o Designer de Projeto for exibido, clique na guia Compilar.
Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio neste artigo. Você pode estar usando uma edição diferente do Visual Studio ou configurações de ambiente diferentes. Para obter mais informações, consulte Personalizar o IDE.
Configuração e Plataforma
As configurações a seguir permitem que você selecione a configuração e a plataforma a serem exibidas ou modificadas.
Observação
Com configurações de compilação simplificadas, o sistema de projeto determina se deve construir uma versão de depuração ou de lançamento. Portanto, as listas Configuration e Platform não são exibidas.
de configuração
Especifica quais definições de configuração devem ser exibidas ou modificadas. As configurações são Debug (padrão), Releaseou All Configurations. Para obter mais informações, consulte Noções básicas sobre configurações de compilação e Como criar e editar configurações.
Plataforma
Especifica quais configurações de plataforma devem ser exibidas ou modificadas. Você pode especificar Qualquer de CPU (padrão), x64 ou x86.
Opções de configuração do compilador
As configurações a seguir permitem que você defina as opções de configuração do compilador.
Construir caminho de saída
Especifica o local dos arquivos de saída para a configuração deste projeto. Digite o caminho da saída da compilação nesta caixa ou clique no botão Procurar para selecionar um caminho. Note que o caminho é relativo; Se você inserir um caminho absoluto, ele será salvo como relativo. O caminho padrão é bin\Debug\ ou bin\Release\.
Com configurações de compilação simplificadas, o sistema de projeto determina se deve construir uma versão de depuração ou de lançamento. O comando Build do menu Debug (F5) colocará a compilação no local de depuração, independentemente do caminho de saída você especificar. No entanto, o comando Build do menu Build o coloca no local especificado.
Opção explícita
Especifica se deve ser permitida a declaração implícita de variáveis. Selecione On para exigir declaração explícita de variáveis. Isso faz com que o compilador relate erros se as variáveis não forem declaradas antes de serem usadas. Selecione Desativar para permitir a declaração implícita de variáveis.
Essa configuração corresponde à opção de compilador /optionexplicit.
Se um arquivo de código-fonte contiver uma Option Explicit Statement, o valor On ou Off na instrução substituirá a configuração Option Explicit na página Compilar.
Quando você cria um novo projeto, a configuração Option Explicit na página Compile é definida como o valor da configuração Option Explicit na caixa de diálogo Opções . Para exibir ou alterar a configuração nesta caixa de diálogo, no menu Ferramentas , clique em Opções . Na caixa de diálogo Opções de , expanda Projetos e Soluçõese, em seguida, clique em Padrões VB. A configuração padrão inicial de Option Explicit no VB Defaults é On.
Definir opção Explicit para Off geralmente não é uma boa prática. Você pode escrever incorretamente um nome de variável em um ou mais locais, o que causaria resultados inesperados quando o programa é executado.
Opção estrita
Especifica se a semântica de tipo estrita deve ser imposta. Quando opção Strict é On, as seguintes condições causam um erro em tempo de compilação:
Conversões de estreitamento implícitas
Vinculação tardia
Digitação implícita que resulta em um tipo de
Object
Erros implícitos de conversão de estreitamento ocorrem quando há uma conversão de tipo de dados implícita que é uma conversão de estreitamento. Para obter mais informações, consulte Option Strict Statement, Conversões implícitas e explícitase Ampliando e restringindo conversões.
Um objeto é vinculado tardiamente quando é atribuído a uma propriedade ou método de uma variável que é declarada como sendo do tipo Object. Para obter mais informações, consulte Option Strict Statement e Early and Late Binding.
Erros de tipo de objeto implícito ocorrem quando um tipo apropriado não pode ser inferido para uma variável declarada, portanto, um tipo de Object é inferido. Isso ocorre principalmente quando você usa uma instrução Dim para declarar uma variável sem usar uma cláusula As e Option Infer está desativada. Para obter mais informações, consulte Option Strict Statement, Option Infer Statemente o Visual Basic Language Specification.
A configuração Option Strict corresponde à opção compilador /optionstrict.
Se um arquivo de código-fonte contiver um Option Strict Statement, o valor On ou Off na instrução substituirá a configuração Option Strict na página Compile.
Quando você cria um projeto, a configuração Option Strict na página Compile é definida como o valor da configuração Option Strict na caixa de diálogo Opções . Para exibir ou alterar a configuração nesta caixa de diálogo, no menu Ferramentas , clique em Opções . Na caixa de diálogo Opções de , expanda Projetos e Soluçõese, em seguida, clique em Padrões VB. A configuração padrão inicial de Option Strict no VB Defaults é Off.
Opção Advertências individuais estritas
A seção Configurações de Aviso da página Compilação do tem configurações que correspondem às três condições que causam um erro em tempo de compilação quando Option Strict está ativado. Seguem-se estas definições:
Conversão implícita
Vinculação tardia; chamada pode falhar em tempo de execução
Tipo implícito; objeto assumido
Quando você define opção Strict como On, todas essas três definições de configuração de aviso são definidas como Error. Quando você define Opção Estrita como Desativado, todas as três configurações são definidas como Nenhuma.
Você pode alterar individualmente cada configuração de aviso para Nenhum, de Aviso ou de Erro . Se todas as três definições de configuração de aviso estiverem definidas como de erro , On aparecerá na caixa Option strict. Se todos os três estiverem definidos como Nenhum, Off aparecerá nesta caixa. Para qualquer outra combinação dessas configurações, (personalizada) é exibida.
Opção comparar
Especifica o tipo de comparação de cadeia de caracteres a ser usado. Selecione binário para instruir o compilador a usar comparações de cadeia de caracteres binárias que diferenciam maiúsculas de minúsculas. Selecione de texto para usar comparações de cadeia de texto específicas da localidade e que não diferenciam maiúsculas de minúsculas.
Essa configuração corresponde à opção de compilador /optioncompare.
Se um arquivo de código-fonte contiver uma instrução Option Compare, o valor Binary ou Text na instrução substituirá a configuração Option Compare na página Compile.
Quando você cria um projeto, a configuração Option Compare na página Compile é definida como o valor da configuração Option Compare na caixa de diálogo Opções . Para exibir ou alterar a configuração nesta caixa de diálogo, no menu Ferramentas , clique em Opções . Na caixa de diálogo Opções de , expanda Projetos e Soluçõese, em seguida, clique em Padrões VB. A configuração padrão inicial de Option Compare no VB Defaults é Binary.
Opção inferir
Especifica se a inferência de tipo local deve ser permitida em declarações de variáveis. Selecione On para permitir o uso da inferência de tipo local. Selecione Desativar para bloquear a inferência de tipo local.
Essa configuração corresponde à opção /optioninfer compilador.
Se um arquivo de código-fonte contiver uma instrução Option Infer, o valor On ou Off na instrução substituirá a configuração Option Infer na página Compile.
Quando você cria um projeto, a configuração Option Infer na página Compilar é definida como o valor da configuração Option Infer na caixa de diálogo Opções . Para exibir ou alterar a configuração nesta caixa de diálogo, no menu Ferramentas , clique em Opções . Na caixa de diálogo Opções de , expanda Projetos e Soluçõese, em seguida, clique em Padrões VB. A configuração padrão inicial de Option Infer no VB Defaults é On.
CPU de destino
Especifica o processador a ser direcionado pelo arquivo de saída. Especifique x86 para qualquer processador compatível com Intel de 32 bits, x64 para qualquer processador compatível com Intel de 64 bits, ARM para qualquer processador ARM ou Qualquer de CPU para especificar que qualquer processador é aceitável. Qualquer de CPU é o valor padrão para novos projetos, pois permite que o aplicativo seja executado no maior número de tipos de hardware.
Para obter mais informações, consulte /platform (Visual Basic).
Prefira de 32 bits
Se a caixa de seleção Prefer32-bit estiver marcada, o aplicativo será executado como um aplicativo de 32 bits nas versões de 32 bits e 64 bits do Windows. Caso contrário, o aplicativo é 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.
A execução como um aplicativo de 64 bits dobra o tamanho do ponteiro e pode causar problemas de compatibilidade com bibliotecas que são exclusivamente de 32 bits. Faz sentido executar um aplicativo como 64 bits somente se ele for executado significativamente mais rápido ou precisar de mais de 4 GB de memória.
Esta caixa de seleção só estará disponível se todas as seguintes condições forem verdadeiras:
Na Página de Compilação, a lista CPU de destino está definida como Qualquer CPU.
Na Página do Aplicativo, a lista Tipo de Aplicativo especifica que o projeto é um aplicativo.
No Página do Aplicativo, a lista da estrutura de de destino especifica o .NET Framework 4.5.
Configurações de aviso
Esta tabela lista as condições de compilação e o nível de notificação correspondente de Nenhum, de Aviso ou de Erro para cada um.
Por padrão, todos os avisos do compilador são adicionados à Lista de Tarefas durante a compilação. Selecione Desativar todos os avisos instruir o compilador a não emitir avisos ou erros. Selecione Tratar todos os avisos como erros se quiser que o compilador trate os avisos como erros que devem ser corrigidos.
Desativar todos os avisos
Especifica se o compilador deve permitir que o compilador emita notificações conforme especificado na tabela Condition and Notification descrita anteriormente neste documento. Por padrão, essa caixa de seleção está desmarcada. Marque essa caixa de seleção para instruir o compilador a não emitir avisos ou erros.
Essa configuração corresponde à opção de compilador /nowarn.
Tratar todos os avisos como erros
Especifica como tratar avisos. Por padrão, essa caixa de seleção é desmarcada, para que todas as notificações de aviso permaneçam definidas como Aviso. Marque essa caixa de seleção para alterar todas as notificações de aviso para de erro .
Esta opção só estará disponível se Desativar todos os avisos estiver desmarcada.
Gerar arquivo de documentação XML
Especifica se as informações da documentação devem ser geradas. Por padrão, essa caixa de seleção é marcada, instruindo o compilador a gerar informações de documentação e incluí-las em um arquivo XML. Desmarque essa caixa de seleção para instruir o compilador a não criar documentação.
Essa configuração corresponde à opção compilador /doc.
Registe-se para de interoperabilidade COM
Especifica se seu aplicativo gerenciado irá expor um objeto COM (um wrapper chamável COM) que permite que um objeto COM interaja com o aplicativo.
Por padrão, essa caixa de seleção é desmarcada, o que especifica que o aplicativo não permitirá interoperabilidade COM. Marque essa caixa de seleção para permitir a interoperabilidade COM.
Esta opção não está disponível para projetos de Aplicativo do Windows ou Aplicativo de Console.
Construir eventos
Clique neste botão para acessar a caixa de diálogo Build Events. Use esta caixa de diálogo para especificar instruções de configuração pré e pós-compilação para o projeto. Esta caixa de diálogo aplica-se apenas a projetos do Visual Basic. Para obter mais informações, consulte caixa de diálogo Criar eventos (Visual Basic).
Opções avançadas de compilação
Clique neste botão para acessar a caixa de diálogo Configurações do AdvancedCompiler. Use a caixa de diálogo AdvancedCompiler Settings para especificar as propriedades de configuração de compilação avançadas de um projeto. Esta caixa de diálogo aplica-se apenas a projetos do Visual Basic. Para obter mais informações, consulte caixa de diálogo Configurações avançadas do compilador (Visual Basic).