Interaction.DeleteSetting(String, String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Supprime un paramètre de section ou de clé pour une application dans la base de registres Windows. My
permet une meilleure productivité et de meilleures performances dans les opérations de Registre que la fonction DeleteSetting
. Pour plus d'informations, consultez 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)
Paramètres
- AppName
- String
Obligatoire. Expression String
contenant le nom de l'application ou du projet auquel s'applique le paramètre de section ou de clé.
- Section
- String
Obligatoire. Expression String
contenant le nom de la section à partir de laquelle le paramètre de clé est supprimé. Si seuls sont spécifiés AppName
et Section
, la section spécifiée est supprimée avec tous les paramètres de clé connexes.
- Key
- String
Optionnel. Expression String
contenant le nom du paramètre de clé supprimé.
- Attributs
Exceptions
L'utilisateur n'est pas connecté.
Exemples
L’exemple suivant utilise d’abord la SaveSetting
procédure pour créer des entrées dans le Registre Windows pour l’application MyApp
, puis utilise la DeleteSetting
fonction pour les supprimer. Étant donné qu’aucun argument n’est Key
spécifié, la section entière Startup
est supprimée, y compris le nom de la section et toutes ses clés.
' 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")
Remarques
Si tous les arguments sont fournis, le paramètre spécifié est supprimé. Une erreur d’exécution se produit si vous tentez d’utiliser DeleteSetting
sur une section ou un paramètre de clé inexistant.
DeleteSetting
nécessite qu’un utilisateur soit connecté, car il fonctionne sous la clé de HKEY_LOCAL_USER
Registre, qui n’est pas active tant qu’un utilisateur ne se connecte pas de manière interactive.
Les paramètres du Registre qui doivent être accessibles à partir d’un processus non interactif (comme Mtx.exe) doivent être stockés sous les HKEY_USER\DEFAULT\Software
clés de HKEY_LOCAL_MACHINE\Software\
Registre ou .