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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Interaction.vb

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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

SupportedOSPlatformAttribute

Exceções

ArgumentException

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 .

Confira também

• GetAllSettings(String, String)
• GetSetting(String, String, String, String)
• SaveSetting(String, String, String, String)
• ArgumentException