Como: Alterar as 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. A configuração escopo determina se a propriedade é somente leitura: A propriedade para um aplicativo-configuração de escopo é somente para leitura, enquanto a propriedade para um usuário-configuração de escopo é de leitura-gravação. Para obter mais informações, consulte Objeto My.Settings (Visual Basic).

ObservaçãoObservaçã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 Configurações de 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. Para obter mais informações, consulte Como: Adicionar ou remover configurações do aplicativo.

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: Configurações de usuário em Visual Basic.

Consulte também

Tarefas

Como: Configurações do aplicativo de leitura no Visual Basic

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

Como: Criar grades de propriedades para configurações de usuário no Visual Basic

Como: Adicionar ou remover configurações do aplicativo

Referência

Objeto My.Settings (Visual Basic)

Conceitos

Configurações de aplicativo

Outros recursos

Gerenciando definições de aplicativo