Compartilhar via


Página Configurações, Designer de Projeto

Use a página Configurações do Designer de Projeto para especificar as configurações de 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 preferências personalizadas de aplicativo e de 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ó de projeto no Gerenciador de Soluções e use o menu de contexto com o 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 do WPF no Visual Studio 2022, em que 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 do 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

Sincronizar restaura as configurações com 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 Logon que permite carregar configurações para um usuário autenticado ou para usuários anônimos. Esse botão só é habilitado 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.

Exibir código

Para projetos em C#, o botão Exibir Código permite exibir o código no arquivo Settings.cs . Esse arquivo define a Settings classe, que permite que você lide com 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. Normalmente, você faz isso no manipulador de eventos de fechamento do formulário principal. Veja a seguir um exemplo de uma chamada para o Save método:

Properties.Settings.Default.Save();

Para projetos do Visual Basic, o botão Exibir Código permite exibir o código no arquivo Settings.vb . Esse arquivo define a MySettings classe, que permite que você lide com eventos específicos no My.Settings objeto. Para obter mais informações sobre como acessar as configurações do aplicativo usando o objeto, consulte as My.Settingsconfigurações de aplicativo do Access.

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

Modificador de acesso

O botão modificador do Access especifica o nível de acesso das Properties.Settings classes auxiliares (em C#) ou My.Settings (no Visual Basic) geradas pelo Visual Studio em Settings.Designer.cs ou Settings.Designer.vb.

Para projetos do 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 é Interna em C# e Amigo no Visual Basic. Quando o Visual Studio gera classes auxiliares como Internas ou Amigas, 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.

Grade de configurações

A Grade de Configurações é usada para definir as configurações do aplicativo. Essa grade 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 frequência aparecem na lista suspensa, por exemplo, Cadeia de caracteres, (cadeia de conexão)e System.Drawing.Font. Você pode escolher outro tipo selecionando Procurar no final da lista e selecionando um tipo na caixa de diálogo Selecionar um Tipo . Depois de escolher um tipo, ele é adicionado aos tipos comuns na lista suspensa (somente para a solução atual).

Important

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

Scope

Selecione Aplicativo ou Usuário.

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

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

Value

Os dados ou o valor associados à configuração do aplicativo. Por exemplo, se a configuração for uma fonte, seu valor poderá ser Verdana, 9,75pt, style=Bold.

Consulte também