Objeto My.Settings

  • Artigo

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

Comentários

O objeto My.Settings fornece acesso às configurações do aplicativo e permite armazenar e recuperar dinamicamente configurações de propriedade e outras informações sobre o seu aplicativo. Para obter mais informações, consulte Gerenciando configurações de aplicativo (.NET).

Propriedades

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

Cada configuração tem um Name, Type, Scope e Value, que determinam como a propriedade acessa cada configuração que aparece no objeto My.Settings:

  • Name determina o nome da propriedade.

  • Type determina o tipo da propriedade.

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

  • Value é o valor padrão da propriedade.

Métodos

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

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

Tarefas

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

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

Exemplo

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

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

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

Confira também