Página de Aplicativo, Designer de Projeto (Visual Basic)

Use a página Aplicativo do Designer de Projeto para especificar as propriedades e configurações de aplicativo de um projeto.

Para acessar a página Aplicativo, escolha um nó de projeto (não o nó Solução) no Gerenciador de Soluções. Em seguida, escolha Projeto>Propriedades na barra de menus. Quando o Designer de Projeto for exibido, selecione a guia Aplicativo.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de 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, confira Personalizar o IDE.

Configurações gerais de aplicativos

As opções a seguir permitem definir as configurações gerais para um aplicativo.

Nome do assembly

Especifica o nome do arquivo de saída que conterá o manifesto do assembly. Se você alterar essa propriedade, a propriedade Nome de Saída também será alterada.

Também é possível especificar o nome do arquivo de saída em um prompt de comando usando a opção de compilador entrada/saída (Visual Basic).

Para obter informações sobre como acessar esta propriedade de forma programática, consulte AssemblyName.

Namespace raiz

Especifica o namespace base para todos os arquivos no projeto. Por exemplo, se você configurasse o Namespace raiz para Project1 e tivesse um Class1 fora de qualquer namespace em seu código, seu namespace seria Project1.Class1. Se você tivesse um Class2 em um namespace Order no código, seu namespace seria Project1.Order.Class2.

Se você desmarcar Namespace raiz, será possível especificar a estrutura do namespace do seu projeto no código.

Observação

Se você usar a palavra-chave Global em uma Instrução Namespace, será possível definir um namespace fora do namespace raiz do seu projeto. Se você desmarcar a Namespace raiz, Global se tornará o namespace de nível superior, que acaba com a necessidade da palavra-chave Global em uma instrução Namespace. Para obter mais informações, consulte "Palavra-chave nas declarações de Namespace global" em Namespaces no Visual Basic.

Para obter informações sobre como criar namespaces no seu código, consulte Instrução Namespace.

Para obter mais informações sobre a propriedade de namespace raiz, consulte /rootnamespace.

Para obter informações sobre como acessar esta propriedade de forma programática, consulte RootNamespace.

Estrutura de destino (todas as configurações)

Especifica a versão do .NET direcionada pelo aplicativo. Essa opção pode ter valores diferentes dependendo de quais versões do .NET estão instaladas no computador.

Para projetos .NET Framework, o valor padrão corresponde à estrutura de destino que você especificou quando criou o projeto.

Observação

Os pacotes de pré-requisitos listados na Caixa de diálogo Pré-requisitos são definidos automaticamente quando você abre a caixa de diálogo pela primeira vez. Se você alterar posteriormente a estrutura de destino do projeto, será necessário especificar os pré-requisitos manualmente para corresponder à nova estrutura de destino.

Para obter mais informações, confira Visão geral do direcionamento de estrutura.

Tipo de aplicativo

Especifica o tipo de aplicativo a ser compilado. Os valores são diferentes dependendo do tipo de projeto. Por exemplo, para um projeto do Aplicativo do Windows Forms, é possível especificar o Aplicativo do Windows Forms, a Biblioteca de Classes, o Aplicativo de Console, o Serviço Windows ou a Biblioteca de Controles da Web.

Para um projeto de aplicativo Web, é necessário especificar Biblioteca de Classes.

Para obter mais informações sobre a propriedade Tipo de aplicativo, consulte /target (Visual Basic). Para obter informações sobre como acessar essa propriedade de forma programática, consulte OutputType.

Gerar redirecionamentos de associação automaticamente

Os redirecionamentos da associação serão adicionados ao seu projeto se o aplicativo ou seus componentes referenciarem mais de uma versão do mesmo assembly. Se você desejar definir manualmente os redirecionamentos de associação no arquivo de projeto, desmarque Gerar Redirecionamentos de Associação Automaticamente.

Para obter mais informações sobre o redirecionamento, confira Redirecionando versões de assembly.

Formulário de inicialização/ objeto de inicialização/ URI de inicialização

Especifica o formulário de inicialização ou ponto de entrada do aplicativo.

Se Habilitar estrutura de aplicativo estiver selecionado (o padrão), essa lista será denominada Formulário de inicialização e mostrará somente formulários, porque a estrutura de aplicativo dá suporte somente a formulários de inicialização, não objetos.

Se o projeto for um Aplicativo de Navegador do WPF, essa lista será denominada URI de inicialização e o padrão será Page1.xaml. A lista URI de inicialização permite que você especifique o recurso de interface do usuário (um elemento XAML) que o aplicativo exibe quando o ele é iniciado. Para obter mais informações, consulte StartupUri.

Se Habilitar estrutura de aplicativo estiver desmarcado, essa lista se tornará Objeto de inicialização e mostrará os formulários e classes ou módulos com um Sub Main.

Objeto de inicialização define o ponto de entrada a ser chamado quando o aplicativo é carregado. Geralmente, isso é definido como o principal formulário em seu aplicativo ou como o procedimento Sub Main que deve ser executado quando o aplicativo é iniciado. Como as bibliotecas de classe não têm um ponto de entrada, sua única opção para essa propriedade é (Nenhum). Para obter mais informações, consulte /main. Para acessar essa propriedade de forma programática, consulte StartupObject.

ícone

Define o arquivo .ico que você deseja usar como o ícone do programa. Selecione <Procurar...> para procurar um gráfico existente. Consulte -win32icon (ou -win32icon (opções do compilador C#)) para obter mais informações. Para acessar essa propriedade de forma programática, consulte ApplicationIcon.

Informações do assembly

Clique neste botão para exibir a Caixa de diálogo de Informações do Assembly.

Habilitar estrutura do aplicativo

Especifica se um projeto usará a estrutura de aplicativo. A configuração dessa opção afeta as opções disponíveis em Formulário de inicialização/Objeto de inicialização.

Se essa caixa de seleção estiver selecionada, seu aplicativo usará o padrão Sub Main. Marcar essa caixa de seleção habilita os recursos na seção Propriedades da estrutura dos aplicativos do Windows e também exige que você selecione um formulário de inicialização.

Se essa caixa de seleção estiver desmarcada, seu aplicativo usará o Sub Main personalizado que você especificou no Formulário de inicialização. Nesse caso, é possível especificar um objeto de inicialização (um Sub Main personalizado em um método ou em uma classe) ou um formulário. Além disso, as opções na seção Propriedades da estrutura dos aplicativos do Windows ficam indisponíveis.

Exibir configurações do Windows

Clique neste botão para gerar e abrir o arquivo app.manifest. O Visual Studio usa esse arquivo para gerar dados de manifesto do aplicativo. Em seguida, defina o nível de execução solicitado pelo UAC modificando a tag <requestedExecutionLevel> no app.manifest da seguinte maneira:

<requestedExecutionLevel level="asInvoker" />

O ClickOnce funciona com um nível de asInvoker ou no modo virtualizado (não há geração de manifesto). Para especificar o modo virtualizado, remova toda a marcação de app.manifest.

Propriedades da estrutura do aplicativo do Windows

As seguintes configurações estão disponíveis na seção Propriedades da estrutura dos aplicativos do Windows. Essas opções estarão disponíveis somente se a caixa de seleção Habilitar estrutura de aplicativo estiver selecionada.

Dica

A seção depois desta descreve as configurações Propriedades da estrutura do aplicativos do Windows específicas para aplicativos WPF (Windows Presentation Foundation).

Habilitar estilos visuais do Windows

Habilita ou desabilita os estilos visuais do Windows, também conhecidos como Temas do Windows. Os estilos visuais do Windows habilitam, por exemplo, controles com cantos arredondados e cores dinâmicas. O padrão é habilitado.

Criar um aplicativo de instância única

Marque esta caixa de seleção para impedir que usuários executem várias instâncias do aplicativo. A configuração padrão para essa caixa de seleção é desmarcada, o que permite que várias instâncias do aplicativo sejam executadas. Para saber mais, confira o evento StartupNextInstance.

Salvar My.Settings no desligamento

Marque esta caixa de seleção para especificar que as configurações My.Settings do aplicativo são salvas quando os usuários desligam seus computadores. A configuração padrão é habilitado. Se essa opção estiver desabilitada, será possível salvar as configurações do aplicativo manualmente chamando My.Settings.Save.

Modo de autenticação

Selecione Windows (o padrão) para especificar o uso da autenticação do Windows para identificar o usuário conectado no momento. É possível recuperar essas informações no tempo de execução usando o objeto My.User. Selecione Definido pelo aplicativo se você for fornecer seu próprio código para autenticar usuários em vez de usar os métodos de autenticação padrão do Windows.

Modo de desligamento

Selecione Quando o formulário de inicialização fechar (o padrão) para especificar que o aplicativo saia quando o formulário definido como o formulário de inicialização for fechado, mesmo se outros formulários estiverem abertos. Selecione Quando o último formulário fechar para especificar que o aplicativo saia quando o último formulário for fechado ou quando a instrução My.Application.Exit ou End for chamada explicitamente.

Selecione No desligamento explícito para especificar que o aplicativo saia quando você chamar explicitamente Shutdown.

Selecione No fechamento da última janela para especificar que o aplicativo saia quando a última janela for fechada ou quando você chamar explicitamente Shutdown. Essa é a configuração padrão.

Selecione No fechamento da janela principal para especificar que o aplicativo saia quando a janela principal for fechada ou quando você chamar explicitamente Shutdown.

Tela inicial

Selecione o formulário que você deseja usar como uma tela inicial. É necessário ter criado anteriormente uma tela inicial usando um formulário ou modelo. O padrão é (Nenhum).

Exibir eventos de aplicativo

Clique neste botão para exibir um arquivo de código de eventos no qual você pode gravar eventos para os eventos de estrutura do aplicativo Startup, Shutdown, UnhandledException, StartupNextInstance e NetworkAvailabilityChanged. Também é possível substituir determinados métodos de estrutura do aplicativo. Por exemplo, é possível alterar o comportamento de exibição da tela inicial substituindo OnInitialize.

Propriedades de estrutura do aplicativo do Windows para aplicativos WPF (Windows Presentation Foundation)

As seguintes configurações estarão disponíveis na seção Propriedades da estrutura do aplicativo do Windows quando o projeto for um aplicativo WPF (Windows Presentation Foundation). Essas opções estarão disponíveis somente se a caixa de seleção Habilitar estrutura de aplicativo estiver selecionada. As opções listadas nesta tabela estão disponíveis somente para aplicativos WPF ou aplicativos de navegador WPF. Elas não estão disponíveis para bibliotecas de controle de usuário ou de controle personalizado WPF.

Modo de desligamento

Esta propriedade é aplicável somente a aplicativos WPF (Windows Presentation Foundation).

Selecione No desligamento explícito para especificar que o aplicativo saia quando você chamar explicitamente Shutdown.

Selecione No fechamento da última janela para especificar que o aplicativo saia quando a última janela for fechada ou quando você chamar explicitamente Shutdown. Essa é a configuração padrão.

Selecione No fechamento da janela principal para especificar que o aplicativo saia quando a janela principal for fechada ou quando você chamar explicitamente Shutdown.

Para obter mais informações sobre como usar essa configuração, consulte Shutdown

Editar XAML

Este botão abre o arquivo de definição de aplicativo (Application.xaml) no editor XAML. Quando você clicar neste botão, Application.xaml será aberto no nó de definição de aplicativo. Talvez seja necessário editar esse arquivo para executar determinadas tarefas, como a definição de recursos. Se o arquivo de definição de aplicativo não existir, o Designer de Projeto criará um.

Exibir eventos de aplicativo

Este botão abre o arquivo de classe Application (Application.xaml.vb) em um editor de código. Se o arquivo não existir, o Designer de Projeto criará um com o namespace e o nome de classe apropriado.

O objeto Application gera eventos quando ocorrem determinadas alterações no estado do aplicativo (por exemplo, na inicialização ou no desligamento do aplicativo). Para obter uma lista completa dos eventos que essa classe expõe, consulte Application. Esses eventos são manipulados na seção de código do usuário da classe parcial Application.