Partilhar via


Interaction.DeleteSetting(String, String, String) Método

Definição

Exclui uma seção ou uma configuração de chave da entrada de um aplicativo no Registro do Windows. O recurso My oferece melhor produtividade e desempenho em operações do Registro do que a função DeleteSetting. Para obter mais informações, consulte Registry.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void DeleteSetting (string AppName, string? Section = default, string? Key = default);
public static void DeleteSetting (string AppName, string Section = default, string Key = default);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member DeleteSetting : string * string * string -> unit
static member DeleteSetting : string * string * string -> unit
Public Sub DeleteSetting (AppName As String, Optional Section As String = Nothing, Optional Key As String = Nothing)

Parâmetros

AppName
String

Obrigatórios. Expressão String que contém o nome do aplicativo ou do projeto ao qual a seção ou configuração de chave se aplica.

Section
String

Obrigatórios. Expressão String 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

Opcional. Expressão String que contém o nome da configuração de chave que está sendo excluída.

Atributos

Exceções

O usuário não está conectado.

Exemplos

O exemplo a seguir primeiro usa o SaveSetting procedimento para fazer entradas no Registro do Windows para o MyApp aplicativo e, em seguida, usa a DeleteSetting função 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 ou configuração de chave inexistente.

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 do HKEY_LOCAL_MACHINE\Software\ registro ou HKEY_USER\DEFAULT\Software .

Aplica-se a

Confira também