Como: alterar configurações de usuário em Visual Basic

Você pode alterar uma configuração do usuário atribuindo um novo valor à propriedade da configuração no objeto My.Settings.

O objeto My.Settings expõe cada configuração como uma propriedade.O nome da propriedade é o mesmo do nome da configuração, e o tipo da propriedade é o mesmo do tipo da configuração.O Scope da configuração determina se a propriedade é somente leitura; a propriedade para uma configuração com escopo de Application é somente para leitura, enquanto a propriedade para uma configuração com escopo de User é de leitura e escrita.Para obter mais informações, consulte Objeto My.Settings.

Observação

Embora você possa alterar e salvar os valores das configurações de escopo de usuário em tempo de execução, configurações de escopo de aplicativo são somente para leitura e não podem ser alteradas através de programação.Você pode alterar configurações de escopo de aplicativo quando você cria o aplicativo usando o Project Designer, ou editando o arquivo de configuração do aplicativo.Para obter mais informações, consulte Gerenciamento de configurações do aplicativo.

Exemplo

Este exemplo altera o valor da configuração do usuário Nickname.

Sub ChangeNickname(ByVal newNickname As String)
    My.Settings.Nickname = newNickname
End Sub

Para que este exemplo funcione, seu aplicativo deve ter uma configuração de usuário Nickname, do tipo String.

O aplicativo salva as configurações de usuário quando o aplicativo é desligado.Para salvar as configurações imediatamente, chame o método My.Settings.Save.Para obter mais informações, consulte Como: manter configurações do usuário em Visual Basic.

Consulte também

Tarefas

Como: ler as configurações do aplicativo em Visual Basic

Como: manter configurações do usuário em Visual Basic

Como: criar grades de propriedades para as configurações de usuário em Visual Basic

Referência

Objeto My.Settings

Conceitos

Gerenciamento de configurações do aplicativo