VB2005 - Salvando as configurações da aplicação do usuário

VB.2005 - Salvando as configurações

Um novo recurso oferecido pelo VB 2005 refere-se a habilidade de salvar a configuração da aplicação do usuário no arquivo user.config que é salvo no perfil do usuário.

Nas versões anteriores não era fácil salvar as configurações do usuário para uma aplicação, você tinha que salvar no registro ou em um arquivo .ini ou em um arquivo texto personalizado.

Para incluir a configuração da aplicação ou do usuário em um projeto , clique com o botão direito do mouse sobre o nome do projeto na janela Solution Explorer e selecione a opção Properties

Quando uma nova configuração é incluída no descrito do VB2005, uma propriedade publica é criada no namespace My.Settings. Dependendo do escopo da configuração a propriedade será somente-leitura ou com permissão de escrita. Isto permite que você altere via código os valores da configuração do usuário e salve-os usando o método My.Settings.Save().

Uma segunda forma de salvar as configurações é habilitar a configuração 'Save My.Settings on Shutdown' na sua aplicação. Para fazer isto repita o procedimento adotado para incluir uma configuração e selecione a opção Application; a seguir deixe marcada a opção 'Save My.Settings on Shutdown' conforme a figura abaixo:

Um exemplo de utilização

Um exemplo clássico de utilização de configuração do usuário é restaurar as últimas dimensões salva do formulário da aplicação antes dela ser encerrada.

Primeiro crie uma nova aplicação do tipo Windows Application no VB 2005 com o nome de salvaConfig.

Agora vamos definir algumas configurações para esta aplicação. Clique com o botão direito do mouse sobre o nome do projeto na janela Solution Explorer e selecione a opção Properties; A seguir na guia Settings defina as seguintes propriedades:

Não esqueça de definir a propriedade Roaming para True quando o escopo for User.

No formulário padrão da aplicação form1.vb inclua 2 componentes GroupBox, 3 TextBox, 3 Label e 2 botões de comando conforme a figura abaixo:

Agora no evento Load do formulário vamos definir as propriedades para o formulário obtendo-as do arquivo de configuração e exibindo-as no formulário:

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

Me.Size = My.Settings.Tamanho

Me.Location = My.Settings.Localizacao

Me.Text = My.Settings.Texto

txtTamanho.Text = My.Settings.Tamanho.ToString

txtLocalizacao.Text = My.Settings.Localizacao.ToString

txtTexto.Text = My.Settings.Texto.ToString

End Sub

Agora para salvar as configurações ao sair vamos incluir uma rotina chamada salvarConfiguracoes com o seguinte código:

Private Sub salvaConfiguracoes()

Try

'salva a configuração do usuário atual para o tamanho e localização do formulario

My.Settings.Tamanho = Me.Size

My.Settings.Localizacao = Me.Location

My.Settings.Save()

MsgBox("configurações salvas com sucesso...")

Catch ex As Exception

MsgBox("Erro a salvar as configurações...)")

End Try

End Sub

Agora no evento Click do botão Salvar e no evento FormClosing incluímos a chamada a esta rotina para salvar as configurações:

Private Sub btnSalvar_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnSalvar.Click

salvaConfiguracoes()

End Sub

Private Sub Form1_FormClosing(ByVal sender As Object, ByVal e As System.Windows.Forms.FormClosingEventArgs) Handles Me.FormClosing

salvaConfiguracoes()

End Sub

Pronto ! Basta executar este singelo projeto para ver o VB 2005 apresentar um formulário contendo as configurações definidas. Altere os valores e clique em Salvar para armazenar novos valores que serão exibidos na próxima execução.