Interaction.DeleteSetting(String, String, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Apaga uma secção ou definição de chave da entrada de uma aplicação no registo do Windows. A My funcionalidade dá-lhe maior produtividade e desempenho nas operações do registo do que a própria 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 contendo o nome da aplicação ou projeto ao qual a configuração de secção ou chave se aplica.
- Section
- String
Required.
String expressão contendo o nome da secção da qual a definição de chave está a ser eliminada. Se apenas AppName e Section forem fornecidos, a secção especificada é eliminada juntamente com todas as definições de teclas relacionadas.
- Key
- String
Optional.
String expressão contendo o nome da definição da chave que está a ser eliminada.
Exceções
O utilizador não está logado.
Exemplos
O exemplo seguinte utiliza primeiro o procedimento SaveSetting para fazer entradas no registo Windows da aplicação MyApp, e depois usa a função DeleteSetting para as remover. Como nenhum Key argumento é especificado, toda Startup a secção é eliminada, incluindo o nome da secção e todas as suas tonalidades.
' 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")
Observações
Se todos os argumentos forem fornecidos, a configuração especificada é eliminada. Ocorre um erro em tempo de execução se tentar usar DeleteSetting numa secção ou configuração de chave inexistente.
DeleteSetting requer que um utilizador esteja iniciado sessão, uma vez que opera sob a chave do HKEY_LOCAL_USER registo, que não está ativa até que o utilizador inicie sessão interativamente.
As definições do registo que devem ser acedidas a partir de um processo não interativo (como Mtx.exe) devem ser armazenadas sob as HKEY_LOCAL_MACHINE\Software\ ou as HKEY_USER\DEFAULT\Software chaves do registo.