Função DeleteSetting

Artigo
08/25/2010

Exclui uma seção ou configuração principal da entrada de um aplicativo no registro do Windows.

O recurso My proporciona maior produtividade e desempenho em operações de registro do que a função DeleteSetting .Para obter mais informações, consulte Objeto My.Computer.Registro.

Public Sub DeleteSetting( _
   ByVal AppName As String, _
   Optional ByVal Section As String = Nothing, _
   Optional ByVal Key As String = Nothing _
)

Parâmetros

AppName
Obrigatório.String expressão que contém o nome do aplicativo ou projeto ao qual a seção ou chave de configuração se aplica.
Section
Obrigatório.String expressão que contém o nome da seção da qual o chave configuração está sendo excluída. Se apenas AppName e Section são fornecidas, a seção especificada é excluída juntamente com todas as configurações principais relacionadas.
Key
Opcional.String expressão que contém o nome do chave definindo sendo excluído.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Configuração Section, AppName, ou Key não existe.
ArgumentException	5	Usuário não está conectado.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Se todos os argumentos forem fornecidos, a configuração especificada será excluída.Um erro em tempo de execução ocorre se você tentar usar DeleteSetting em uma seção inexistente ou configuração principal.

DeleteSetting requer que um usuário tenha feito logon desde que se opere sob a chave de registro HKEY_LOCAL_USER , que não está ativa até que um usuário efetue logon interativamente.

Configurações de registro que devem acessadas a partir de um processo não interativo (como Mtx.exe) devem ser armazenadas em HKEY_LOCAL_MACHINE\Software\ ou as chaves de registro HKEY_USER\DEFAULT\Software.

Exemplo

O exemplo a seguir primeiro usa o procedimento SaveSetting para tornar as entradas no registro do Windows para o aplicativo MyApp e em seguida, usa a função DeleteSetting para removê-los.Porque nenhum argumento Key foi especificado, toda a seção Startup será excluída, incluindo o nome seção e todas suas chaves.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")