Interaction.DeleteSetting(String, String, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exclui uma seção ou uma configuração de chave da entrada de um aplicativo no registro Windows. O My recurso oferece maior produtividade e desempenho em operações do Registro do que a DeleteSetting função. Para obter mais informações, consulte Registry.
public static void DeleteSetting(string AppName, string Section = default, string Key = default);static member DeleteSetting : string * string * string -> unitPublic Sub DeleteSetting (AppName As String, Optional Section As String = Nothing, Optional Key As String = Nothing)Parâmetros
- AppName
- String
Required.
String expressão que contém o nome do aplicativo ou projeto ao qual a seção ou a configuração de chave se aplica.
- Section
- String
Required.
String expressão que contém o nome da seção da qual a configuração de chave está sendo excluída. Se apenas AppName e Section forem fornecidos, a seção especificada será excluída juntamente com todas as configurações de chave relacionadas.
- Key
- String
Optional.
String expressão que contém o nome da configuração de chave que está sendo excluída.
Exceções
O usuário não está conectado.
Exemplos
O exemplo a seguir primeiro usa o procedimento SaveSetting para fazer entradas no registro Windows para o aplicativo MyApp e, em seguida, usa a função DeleteSetting para removê-las. Como nenhum Key argumento é especificado, toda Startup a seção é excluída, incluindo o nome da seção e todas as 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")
Comentários
Se todos os argumentos forem fornecidos, a configuração especificada será excluída. Ocorrerá um erro em tempo de execução se você tentar usar DeleteSetting em uma seção inexistente ou configuração de chave.
DeleteSetting requer que um usuário seja conectado, pois ele opera sob a chave do HKEY_LOCAL_USER Registro, que não está ativa até que um usuário faça logon interativamente.
As configurações do Registro que devem ser acessadas de um processo não interativo (como Mtx.exe) devem ser armazenadas nas chaves ou nas chaves do HKEY_LOCAL_MACHINE\Software\HKEY_USER\DEFAULT\Software Registro.