Página do aplicativo, Project Designer (Visual Basic)

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

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

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ções gerais do aplicativo

As opções a seguir permitem que você defina 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 Output Name também será alterada.

Você também pode especificar o nome do arquivo de saída em um prompt de comando usando a opção de compilador /out (Visual Basic).

Para obter informações sobre como acessar essa propriedade programaticamente, consulte AssemblyName.

Namespace raiz

Especifica o namespace base para todos os arquivos no projeto. Por exemplo, se você definir o Namespace Raiz como Project1 e tiver um Class1 fora de qualquer namespace em seu código, seu namespace será Project1.Class1. Se você tiver um Class2 em um namespace Order no código, seu namespace será Project1.Order.Class2.

Se você limpar o namespace raiz, poderá especificar a estrutura do namespace do seu projeto no código.

Observação

Se você usar a Global palavra-chave em uma instrução Namespace, poderá definir um namespace fora do namespace raiz do seu projeto. Se você limpar o namespace raiz, Global torna-se o namespace de nível superior, o que remove a necessidade da Global palavra-chave em uma Namespace instrução. Para obter mais informações, consulte "Global Keyword in Namespace Statements" em Namespaces no Visual Basic.

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

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

Para obter informações sobre como acessar essa propriedade programaticamente, consulte RootNamespace.

Estrutura de destino (todas as configurações)

Especifica a versão do .NET que o aplicativo destina. Esta opção pode ter valores diferentes, dependendo de quais versões do .NET estão instaladas no seu computador.

Para projetos do .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, posteriormente, você alterar a estrutura de destino do projeto, deverá especificar os pré-requisitos manualmente para corresponder à nova estrutura de destino.

Para obter mais informações, consulte a Visão geral sobre a definição de alvo do Framework.

Tipo de aplicação

Especifica o tipo de aplicativo a ser compilado. Os valores são diferentes dependendo do tipo de projeto. Por exemplo, para um projeto de Aplicativo do Windows Forms , você pode especificar Aplicativo do Windows Forms, Biblioteca de Classes, Aplicativo de Console, Serviço do Windows ou Biblioteca de Controle da Web.

Para um projeto de aplicativo Web, você deve especificar Biblioteca de Classes.

Para obter mais informações sobre a propriedade Application type , consulte /target (Visual Basic). Para obter informações sobre como acessar essa propriedade programaticamente, consulte OutputType.

Redirecionamentos de vinculação de geração automática

Os redirecionamentos de vinculação são adicionados ao seu projeto se seu aplicativo ou seus componentes fizerem referência a mais de uma versão do mesmo assembly. Se você quiser definir manualmente redirecionamentos de vinculação no arquivo de projeto, desmarque Redirecionamentos de vinculação de geração automática.

Para obter mais informações sobre redirecionamento, consulte Redirecionamento de 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 o ponto de entrada do aplicativo.

Se a opção Habilitar estrutura de aplicativo estiver selecionada (o padrão), essa lista será intitulada Formulário de inicialização e mostrará apenas formulários porque a estrutura de aplicativo oferece suporte apenas a formulários de inicialização, não a objetos.

Se o projeto for um WPF Browser Application, essa lista será intitulada Startup URI e o padrão será Page1.xaml. A lista URI de inicialização permite especificar o recurso de interface do usuário (um elemento XAML) que o aplicativo exibe quando o aplicativo é iniciado. Para obter mais informações, consulte StartupUri.

Se Enable application framework estiver desmarcado, essa lista se tornará objeto Startup e mostrará formulários e classes ou módulos com um Sub Mainarquivo .

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

Ícone

Define o arquivo de .ico que você deseja usar como ícone do programa. Selecione <Procurar...> para procurar um gráfico existente. Consulte /win32icon (ou /win32icon (C# Compiler Options)) para obter mais informações. Para aceder a esta propriedade programaticamente, consulte ApplicationIcon.

Informações sobre a montagem

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

Habilitar a estrutura do aplicativo

Especifica se um projeto usará a estrutura do aplicativo. A configuração dessa opção afeta as opções disponíveis no objeto Startup form/Startup.

Se essa caixa de seleção estiver marcada, seu aplicativo usará o padrão Sub Main. Marcar essa caixa de seleção habilita os recursos na seção de propriedades da estrutura de 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 personalizado Sub Main que você especificou no formulário de inicialização. Nesse caso, você pode especificar um objeto de inicialização (um personalizado Sub Main em um método ou uma classe) ou um formulário. Além disso, as opções na seção de propriedades da estrutura de aplicativos do Windows ficam indisponíveis.

Ver Definições do Windows

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

<requestedExecutionLevel level="asInvoker" />

ClickOnce funciona com um nível de ou em modo virtualizado (sem geração de asInvoker manifesto). Para especificar o modo virtualizado, remova a tag inteira de app.manifest.

Propriedades da estrutura de aplicativos do Windows

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

Sugestão

A seção a seguir descreve as configurações de propriedades da estrutura de aplicativos do Windows específicas para aplicativos do Windows Presentation Foundation (WPF).

Ativar estilos visuais do Windows

Habilita ou desabilita os estilos visuais do Windows, também conhecidos como Temas do Windows. Os estilos visuais do Windows permitem, por exemplo, controles com cantos arredondados e cores dinâmicas. A predefinição está ativada.

Criar aplicativo de instância única

Marque essa caixa de seleção para impedir que os usuários executem várias instâncias do aplicativo. A configuração padrão para essa caixa de seleção está desmarcada, o que permite que várias instâncias do aplicativo sejam executadas. Para obter mais informações, consulte o evento StartupNextInstance.

Salvar My.Settings no desligamento

Marque essa caixa de seleção para especificar que as configurações do aplicativo são salvas My.Settings quando os usuários desligam seus computadores. A configuração padrão está habilitada. Se essa opção estiver desativada, você poderá 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. Você pode recuperar essas informações em tempo de execução usando o My.User objeto. Selecione Definido pelo aplicativo se você 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 for fechado (o padrão) para especificar que o aplicativo saia quando o formulário definido como o formulário de inicialização for fechado, mesmo que outros formulários estejam abertos. Selecione Quando o último formulário for fechado para especificar que o aplicativo saia quando o último formulário for fechado ou quando My.Application.Exit ou a End instrução for chamada explicitamente.

Selecione Em desligamento explícito para especificar que o aplicativo saia quando você chamar Shutdownexplicitamente .

Selecione Na última janela fechar para especificar que o aplicativo saia quando a última janela fechar ou quando você chamar Shutdownexplicitamente . Esta é a configuração padrão.

Selecione Na janela principal fechar para especificar que o aplicativo saia quando a janela principal for fechada ou quando você chamar Shutdownexplicitamente .

Ecrã inicial

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

Exibir eventos do aplicativo

Clique neste botão para exibir um arquivo de código de eventos no qual você pode escrever eventos para os eventos Startupda estrutura do aplicativo , , ShutdownUnhandledExceptionStartupNextInstancee .NetworkAvailabilityChanged Você também pode substituir determinados métodos de estrutura de aplicativo. Por exemplo, você pode alterar o comportamento de exibição da tela inicial substituindo OnInitialize.

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

As configurações a seguir estão disponíveis na seção de propriedades da estrutura de aplicativos do Windows quando o projeto é um aplicativo do Windows Presentation Foundation (WPF). Essas opções estarão disponíveis somente se a caixa de seleção Habilitar estrutura do aplicativo estiver marcada. As opções listadas nesta tabela estão disponíveis apenas para aplicativos de navegador WPF ou WPF. Eles não estão disponíveis para WPF User Control ou bibliotecas de controle personalizado.

Modo de desligamento

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

Selecione Em desligamento explícito para especificar que o aplicativo saia quando você chamar Shutdownexplicitamente .

Selecione Na última janela fechar para especificar que o aplicativo saia quando a última janela fechar ou quando você chamar Shutdownexplicitamente . Esta é a configuração padrão.

Selecione Na janela principal fechar para especificar que o aplicativo saia quando a janela principal for fechada ou quando você chamar Shutdownexplicitamente .

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

Editar XAML

Esse botão abre o arquivo de definição do aplicativo (Application.xaml) no editor XAML. Quando você clica nesse botão, Application.xaml é aberto no nó de definição do aplicativo. Talvez seja necessário editar esse arquivo para executar determinadas tarefas, como definir recursos. Se o arquivo de definição do aplicativo não existir, o Project Designer criará um.

Exibir eventos do aplicativo

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

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