Compartilhar via


Objeto My.Settings

Fornece propriedades e métodos para acessar as configurações do aplicativo.

Observações

O My.Settings objeto fornece acesso às configurações do aplicativo e permite que você armazene e recupere dinamicamente as configurações de propriedade e outras informações para seu aplicativo. Para obter mais informações, consulte Gerenciando as configurações do aplicativo (.NET).

Propriedades

As propriedades do My.Settings objeto fornecem acesso às configurações do aplicativo. Para adicionar ou remover configurações, use o Designer de Configurações.

Cada configuração tem nome, tipo, escopo e valor e essas configurações determinam como a propriedade para acessar cada configuração aparece no My.Settings objeto:

  • O nome determina o nome da propriedade.

  • O tipo determina o tipo da propriedade.

  • O escopo indica se a propriedade é somente leitura. Se o valor for Application, a propriedade será somente leitura; se o valor for User, a propriedade será leitura/gravação.

  • O valor é o valor padrão da propriedade.

Métodos

Método Descrição
Reload Recarrega as configurações do usuário dos últimos valores salvos.
Save Salva as configurações de usuário atuais.

O My.Settings objeto também fornece propriedades e métodos avançados, herdados da ApplicationSettingsBase classe.

Tarefas

A tabela a seguir lista exemplos de tarefas que envolvem o My.Settings objeto.

Para Veja
Ler uma configuração de aplicativo Como ler as configurações do aplicativo no Visual Basic
Alterar uma configuração de usuário Como alterar as configurações do usuário no Visual Basic
Manter as configurações do usuário Como manter as configurações do usuário no Visual Basic
Criar uma grade de propriedades para as configurações do usuário Como criar grades de propriedade para configurações de usuário no Visual Basic

Exemplo

Este exemplo exibe o valor da Nickname configuração.

Sub ShowNickname()
    MsgBox("Nickname is " & My.Settings.Nickname)
End Sub

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

Consulte também