Compartilhar via


Visão Geral Sobre Configurações do Aplicativo

Este tópico discorre sobre como criar e armazenar dados de configuração em nome do seu aplicativo e seus usuários.

O recurso Configurações de Aplicativo dos Formulários do Windows tornam mais fácil criar, armazenar, e manter preferências personalizadas de aplicativos e usuários no computador cliente.Com as Configurações de Aplicativos dos Formulários do Windows, você pode armazenar não apenas dados do aplicativo, como strings de conexão de bancos de dados, mas também os dados específicos do usuário, como as preferências do usuário a respeito do aplicativo.Usando o Visual Studio ou código gerenciado personalizado, você pode criar novas configurações, lê-las do disco e gravá-las nele, vinculá-las a propriedades em seus formulários e validar os dados de configuração antes de carregá-los e salvá-los.

Configurações do Aplicativo permite que os desenvolvedores salvem o estado em seus aplicativos usando muito pouco código personalizado e é uma substituição para Propriedades Dinâmicas, de versões anteriores do .NET Framework.Configurações do Aplicativo contém vários aprimoramentos de propriedades dinâmicas, as quais são somente leitura, de ligação tardia e exigem mais programação personalizada.As classes de propriedades dinâmicas foram mantidas no .NET Framework versão 2,0,mas são apenas shell classes que envolvem superficialmente as classes de configuração da aplicação.

O que são Configurações do Aplicativo?

Seus aplicativos de Formulários do Windows frequentemente exigirão dados que são críticos para a execução do aplicativo, mas que você não deseja incluir diretamente no código do aplicativo.Se o seu aplicativo usa um Serviço Web ou um servidor de banco de dados, convém armazenar essas informações em um arquivo separado, para que você possa alterá-las no futuro sem recompilação.Da mesma forma, seus aplicativos podem exigir o armazenamento de dados que são específicos do usuário atual.A maioria dos aplicativos, por exemplo, têm preferências do usuário que personalizam a aparência e comportamento do aplicativo.

Configurações do Aplicativo aborda as duas necessidades fornecendo uma maneira fácil armazenar as configurações de escopo do aplicativo e escopo do usuário no computador cliente.Ao usar um editor de códigos ou Visual Studio, você define uma configuração de uma determinada propriedade especificando seu nome, tipo de dado e escopo (aplicativo ou usuário).Você pode até mesmo colocar configurações relacionadas umas com as outras em grupos nomeados para facilitar o uso e a leitura.Uma vez definidas, essas configurações são salvas e trazidas de volta à memória automaticamente em tempo de execução.Uma arquitetura conectável permite que o mecanismo de persistência a ser alterado, mas por padrão, o sistema de arquivos local é usado.

Configurações do Aplicativo funciona gravando dados como XML em arquivos de configuração diferentes, correspondentes ao escopo do aplicativo ou ao escopo do usuário.Na maioria dos casos, as configurações do escopo do aplicativo são somente leitura; porque são informações programa, tipicamente você não precisará redefini-las.Por outro lado, configurações no escopo do usuário podem ser lidos e gravadas com segurança em tempo de execução, mesmo se o seu aplicativo for executado em confiança parcial.Para obter mais informações sobre confiança parcial, consulte Visão Geral da Segurança em Formulários do Windows.

As configurações são armazenadas como fragmentos XML em arquivos de configuração.Configurações do escopo do aplicativo são representadas pelo elemento <application.Settings> e geralmente são colocadas em app .exe.config, onde App é o nome do seu arquivo executável principal.Configurações do escopo do usuário são representadas pelo elemento <userSettings> e são colocadas em usuário .config, onde user é o nome de usuário da pessoa executando o aplicativo no momento.Você deve distribuir o arquivo app .exe.config com o seu aplicativo; a arquitetura das configurações irá criar os arquivos usuário .config por demanda na primeira vez o aplicativo salva configurações para o usuário correspondente.Você também pode definir um bloco <userSettings> dentro de app . exe.config para fornecer valores padrão para as configurações do escopo do usuário.

Controles personalizados também podem salvar suas próprias configurações implementando a interface IPersistComponentSettings, que expõe o método SaveSettings.O controle dos Formulários do Windows ToolStrip implementa essa interface para salvar a posição de barras de ferramentas e itens da barra de ferramentas entre as sessões do aplicativo.Para obter mais informações sobre os controles personalizados e configurações do aplicativo, consulte Configurações do Aplicativo para Controles Personalizados.

Limitações de Configurações do Aplicativo

Não é possível usar Configurações do Aplicativo em um aplicativo não gerenciado que hospeda o .NET Framework.As configurações não funcionarão em ambientes como add-ins do Visual Studio, C++ para Microsoft Office, hospedagem de controles no Internet Explorer, ou add-ins e projetos do Microsoft Outlook.

Atualmente não é possível vincular-se a algumas propriedades em Formulários do Windows.O exemplo mais notável é a propriedade ClientSize, pois vincular-se a esta propriedade causará um comportamento imprevisível no tempo de execução.Você pode geralmente contornar esses problemas salvando e carregando essas configurações por meio de programação.

Configurações do Aplicativo não tem nenhum recurso interno para criptografar informações automaticamente.Você nunca deve armazenar informações relacionadas à segurança, como senhas de banco de dados, em texto não criptografado.Se você desejar armazenar essas informações sigilosas, você como desenvolvedor do aplicativo é responsável por certificar que é seguro fazê-lo.Se você quiser armazenar sequências de caracteres de conexão, é recomendável que você usar segurança integrada do Windows e não recorrer à embutir código senhas para o URL.Para obter mais informações, consulte Segurança Acessar Código and ADO.NET.

Guia de Introdução de Configurações do Aplicativo

Se você usar Visual Studio, você pode definir configurações dentro do Windows Forms Designer usando a propriedade (ApplicationSettings) na janela Properties.Quando você definir as configurações dessa maneira, o Visual Studio cria automaticamente uma classe envoltório de gerenciamento personalizado, que associa cada configuração com uma classe de propriedade.O Visual Studio também cuida da vinculação de uma configuração a uma propriedade de um formulário ou controle para que as configurações do controle sejam restauradas automaticamente quando seu formulário é exibido e salvas automaticamente quando o formulário é fechado.Para obter detalhes, consulte:Como: Criar configurações do aplicativo usando o Designer.

Se você quiser um controle mais detalhado sobre as configurações, você pode definir suas próprias classes envoltório personalizadas para as configurações do aplicativo.Isso é feito derivando uma classe de ApplicationSettingsBase, adicionando uma propriedade que corresponda a cada configuração e aplicando atributos especiais a essas propriedades.Para obter detalhes sobre como criar classes envoltório, consulte Arquitetura das Configurações do Aplicativo.

Você também pode usar a classe Binding para vincular as configurações por programação a propriedades em formulários e controles.Para obter mais informações sobre como criar classes envoltório, consulte Como: Criar configurações do aplicativo usando o Designer.

Consulte também

Tarefas

Como: Criar configurações do aplicativo usando o Designer

Como: Validar configurações do aplicativo

Conceitos

Arquitetura das Configurações do Aplicativo

Configurações do Aplicativo para Controles Personalizados

Referência

ApplicationSettingsBase

SettingsProvider

LocalFileSettingsProvider

IPersistComponentSettings