Compartilhar via


Como alterar configurações do usuário no 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 que o nome da configuração e o tipo de propriedade é o mesmo que o tipo de configuração. O Escopo da configuração determina se a propriedade é somente leitura: a propriedade para uma configuração de escopo do Aplicativo é somente leitura, enquanto que a propriedade para uma configuração de escopo do Usuário é de leitura/gravação. Para obter mais informações, consulte Objeto My.Settings.

Observação

Embora você possa alterar e salvar os valores das configurações de escopo do usuário em tempo de execução, as configurações de escopo do aplicativo são somente leitura e não podem ser alteradas programaticamente. Você pode alterar as configurações de escopo do aplicativo ao criar o aplicativo usando o Designer de Projeto ou editando o arquivo de configuração de aplicativo. Para obter mais informações, consulte Gerenciando configurações de aplicativo (.NET).

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 esse exemplo funcione, seu aplicativo deve ter uma configuração do usuário Nickname, do tipo String.

O aplicativo salva as configurações do 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 persistir configurações do usuário no Visual Basic.

Confira também