Partilhar 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 configurações do aplicativo (.NET).

Propriedades

As propriedades do My.Settings objeto 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 Nome, Tipo, Escopo e Valor, e essas configurações determinam como a propriedade para acessar cada configuração aparece no My.Settings objeto:

  • Name determina o nome da propriedade.

  • Type determina o tipo da propriedade.

  • 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.

  • Value é o valor padrão da propriedade.

Métodos

Método Description
Reload Recarrega as configurações do usuário a partir dos últimos valores salvos.
Save Salva as configurações atuais do usuário.

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 Consulte
Ler uma configuração de aplicativo Como: Ler configurações do aplicativo no Visual Basic
Alterar uma configuração de usuário Como: Alterar configurações de usuário no Visual Basic
Persistir as configurações do usuário Como: Persistir configurações de 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 Nickname valor da 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