Partilhar via


Página Configurações, Project Designer

Use a página Configurações do Designer de Projeto para especificar as configurações do aplicativo de um projeto. As configurações do aplicativo permitem que você armazene e recupere configurações de propriedade e outras informações para seu aplicativo dinamicamente. Eles também permitem que você mantenha o aplicativo personalizado e as preferências do usuário em um computador cliente. Para obter mais informações, consulte Gerenciar configurações do aplicativo.

Para acessar a página Configurações , selecione um nó do projeto no Gerenciador de Soluções e use o menu de contexto do botão direito do mouse para selecionar Propriedades. Quando o Designer de Projeto for exibido, selecione a guia Configurações .

Na guia Configurações , você verá um link Criar ou abrir configurações do aplicativo .

Captura de tela da guia Configurações no Designer de Projeto para um projeto WPF no Visual Studio 2022, onde você clica em um link para gerar dinamicamente a caixa de diálogo Configurações.

Selecione o link Criar ou abrir configurações do aplicativo para abrir uma página Configurações no Designer de Projeto.

Captura de tela da guia Configurações no Designer de Projeto para um projeto WPF no Visual Studio 2022.

Barra de cabeçalho

A barra de cabeçalho na parte superior da página Configurações contém vários controles:

Synchronize

Synchronize restaura as configurações de escopo do usuário que o aplicativo usa em tempo de execução ou durante a depuração para seus valores padrão, conforme definido em tempo de design. Para restaurar os dados, remova arquivos específicos do aplicativo gerados em tempo de execução do disco, não dos dados do projeto.

Carregar configurações da Web

Carregar Configurações da Web exibe uma caixa de diálogo Login que permite carregar configurações para um usuário autenticado ou para usuários anônimos. Esse botão é habilitado somente quando você habilita os serviços de aplicativo cliente na página Serviços e especifica um local de serviço de configurações da Web.

Ver Código

Para projetos C#, o botão View Code permite visualizar o código no arquivo Settings.cs . Esse arquivo define a Settings classe, que permite manipular eventos específicos no Settings objeto. Em idiomas diferentes do Visual Basic, você deve chamar explicitamente o Save método dessa classe wrapper para persistir as configurações do usuário. Você geralmente faz isso no manipulador de eventos Closing do formulário principal. Segue-se um exemplo de uma chamada para o Save método:

Properties.Settings.Default.Save();

Para projetos do Visual Basic, o botão View Code permite que você exiba o código no arquivo Settings.vb . Esse arquivo define a MySettings classe, que permite manipular eventos específicos no My.Settings objeto. Para obter mais informações sobre como acessar as configurações do aplicativo usando o objeto, consulte Configurações do My.Settingsaplicativo do Access.

Para obter mais informações sobre como acessar as configurações do aplicativo, consulte Configurações do aplicativo para Windows Forms.

Modificador de acesso

O botão Modificador de acesso especifica o nível de acesso das classes auxiliares (em C#) ou Properties.Settings (em Visual Basic) que o My.Settings Visual Studio gera em Settings.Designer.cs ou Settings.Designer.vb.

Para projetos Visual C#, o modificador de acesso pode ser interno ou público.

Para projetos do Visual Basic, o modificador de acesso pode ser Amigo ou Público.

Por padrão, a configuração é Interno em C# e Amigo no Visual Basic. Quando o Visual Studio gera classes auxiliares como Interno ou Amigo, os aplicativos executáveis (.exe) não podem acessar os recursos e as configurações que você adicionou às bibliotecas de classes (arquivos.dll ). Se você precisar compartilhar recursos e configurações de uma biblioteca de classes, defina o modificador de acesso como Público.

Para obter mais informações sobre as classes auxiliares de configurações, consulte Gerenciar configurações do aplicativo.

Grelha de configurações

A Grade de Configurações é usada para definir as configurações do aplicativo. Esta grelha inclui as seguintes colunas:

Name

Insira o nome da configuração do aplicativo neste campo.

Type

Use a lista suspensa para selecionar um tipo para a configuração. Os tipos usados com mais freqüência aparecem na lista suspensa, por exemplo, String, (Connection string) e System.Drawing.Font. Você pode escolher outro tipo selecionando Procurar no final da lista e, em seguida, selecionando um tipo na caixa de diálogo Selecionar um tipo . Depois de escolher um tipo, ele é adicionado aos tipos comuns na lista suspensa (apenas para a solução atual).

Important

Procurar está disponível apenas para projetos do .NET Framework. Procurar não está disponível para projetos .NET ou .NET Core.

Scope

Selecione Aplicativo ou Usuário.

As configurações de escopo do aplicativo, como cadeias de conexão, são associadas ao aplicativo. Os usuários não podem alterar as configurações do escopo do aplicativo em tempo de execução.

As configurações de escopo do usuário, como fontes do sistema, destinam-se a ser usadas para as preferências do usuário. Os usuários podem alterá-los em tempo de execução.

Value

Os dados ou o valor associado à configuração do aplicativo. Por exemplo, se a configuração for uma fonte, seu valor pode ser Verdana, 9.75pt, style=Bold.

Consulte também