Objeto My.Settings

Artigo
05/10/2023

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.

Compartilhar via