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

Usando Visual Studio, você pode criar novas configurações do aplicativo e vinculá-las a propriedades do seu formulário ou dos controles do seu formulário, para que estas configurações sejam carregadas e salvas automaticamente em tempo de execução.

No procedimento a seguir, você configurar suas configurações do aplicativo e vínculos usando o Editor de Propriedades dos Formulários do Windows. Quando você usar esse editor, Visual Studio gera um classe envoltório para você que derivada de ApplicationSettingsBase e expõe todas as suas configurações como as propriedades definidas na mesma. No segundo procedimento, você define esta classe envoltório manualmente.

Observação

Usuários do Visual Studio 2005 podem adicionar configurações para seu aplicativo usando o Project Designer adicionando um arquivo .settings para seus aplicativos. Em Visual Basic, isso vai expor todas as definições do objeto My.Settings; outras linguagens irão gerar uma classe Settings que expõe estas configurações. Você pode criar um arquivo .settings em Visual Studio usando a guia Configurações no Project Designer para criar as configurações do projeto.

O Designer de projeto no Microsoft Visual Basic 2005 contém mais opções estiver trabalhando com configurações de aplicativo que os outros idiomas no Microsoft Visual Studio 2005 . Para obter mais informações, consulte Gerenciando definições de aplicativo.

Observação
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Para criar novas configurações de aplicativos usando Visual Studio

1. Selecione o formulário ou controle cujas propriedades você deseja vincular à nova configuração de aplicativo.

2. No Editor de Propriedades, expanda o item (Configurações do Aplicativo) e em seguida, clique na elipse próxima ao item (PropertyBindings) abaixo dele.

3. Na caixa de diálogo Configurações do Aplicativo, clique no menu suspenso da propriedade que você deseja vincular e selecione o comando Nova.

   Importante
   O designer não exibirá as propriedades cujo tipo está definido dentro do assembly atual. Essa é uma limitação conhecida. Para vincular a esta propriedade, use execute uma das seguintes etapas:

   • Mova a definição de tipo de propriedade para outro projeto, compile o projeto e, em seguida, adicione uma referência a esse novo conjunto de módulos (assembly) ao projeto atual. A propriedade deve então estar listada na caixa de diálogo Configurações do Aplicativo.

     - ou -

   • Em vez de usar o Designer, crie a configuração do aplicativo por meio de programação. Para obter mais informações sobre essa opção, consulte Como: Criar configurações do aplicativo.

4. Na caixa de diálogo Nova configuração do aplicativo , defina a configuração, dando a ela nome e um valor padrão (se aplicável) e definindo seu escopo. Se você definir o escopo como Aplicativo, a propriedade será global para todos os usuários do aplicativo, mas provavelmente não será alterável em tempo de execução. Se você definir o escopo para Usuário, a propriedade será de leitura/gravação e seu valor pode diferir de usuário para usuário. Para obter mais informações sobre o escopo das configurações, consulte Visão Geral Sobre Configurações do Aplicativo.

5. Se sua configuração contem uma string de conexão, selecione a caixa String de Conexão na caixa de diálogo.

6. Clique em OK em ambas caixas de diálogo Nova configuração de aplicativo e Configurações do Aplicativo caixa de diálogo. Você criou com êxito uma nova configuração do aplicativo e vinculou-a à propriedade especificada.

7. Para manipular configurações individuais de aplicativos, acessar as propriedades do objeto My.Settings no Visual Basic, ou o objeto Settings em outras linguagens. Por exemplo, em linguagens diferentes de Visual Basic, você deve explicitamente chamar o método Save desta classe envoltório para persistir a Configurações do Usuário. Geralmente isso é feito no manipulador de eventos Closing do formulário principal. Em Visual Basic, o designer gerará automaticamente código para salvar os valores atuais de todas as Configurações do Usuário durante o desligamento do aplicativo.

Segurança

O provedor de configurações padrão, LocalFileSettingsProvider, mantém em disco informações de arquivos de configuração como texto sem-formatação. Isso limita a segurança de acesso a arquivos fornecida pelo sistema operacional para o usuário atual. Por isto, deve-s ter cuidado com as informações armazenadas em arquivos de configuração. Por exemplo, um uso comum para configurações de aplicativo é para armazenar strings de conexão que apontem para o armazenamento de dados do aplicativo. No entanto, por causa de preocupações com segurança, essas sequências de caracteres não devem incluir senhas. Para obter mais informações sobre strings de conexão, consulte SpecialSetting.

Consulte também

Tarefas

Como: Criar configurações do aplicativo

Como: Validar configurações de aplicativo

Referência

LocalFileSettingsProvider

Conceitos

Visão Geral Sobre Configurações do Aplicativo