DeleteSetting, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Supprime un paramètre de section ou de clé pour une application dans la base de registres de Windows.

La fonctionnalité My vous permet une meilleure productivité et de meilleures performances dans les opérations de Registre que la fonction DeleteSetting. Pour plus d'informations, consultez My.Computer.Registry, objet.

Public Sub DeleteSetting( _
   ByVal AppName As String, _
   Optional ByVal Section As String = Nothing, _
   Optional ByVal Key As String = Nothing _
)

Paramètres

AppName
Requis. Expression String contenant le nom de l'application ou du projet auquel s'applique le paramètre de section ou de clé.
Section
Requis. Expression String contenant le nom de la section à partir de laquelle le paramètre de clé est supprimé. Si seuls AppName et Section sont fournis, la section spécifiée est supprimée avec tous les paramètres de clé connexes.
Key
Facultatif. Expression String contenant le nom du paramètre de clé supprimé.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	Paramètre Section, AppName ou Key inexistant.
ArgumentException	5	L'utilisateur n'est pas connecté.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

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 un paramètre de section ou de clé inexistant.

DeleteSetting nécessite qu'un utilisateur soit connecté, car elle fonctionne sous la clé de Registre HKEY_LOCAL_USER, qui n'est active que lorsque l'utilisateur se connecte de façon interactive.

Les paramètres de Registre accessibles via un processus non interactif (tel que Mtx.exe) doivent être stockés au-dessous des clés de Registre HKEY_LOCAL_MACHINE\Software\ ou HKEY_USER\DEFAULT\Software.

Exemple

L'exemple suivant utilise d'abord la procédure SaveSetting pour entrer des données dans la base de registres de Windows pour l'application MyApp, puis utilise la fonction DeleteSetting pour les supprimer. Dans la mesure où aucun argument Key n'est spécifié, l'ensemble de la section Startup est supprimé, 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")