SaveSetting, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Enregistre ou crée une entrée d'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 SaveSetting. Pour plus d'informations, consultez My.Computer.Registry, objet.

Public Sub SaveSetting( _
   ByVal AppName As String, _ 
   ByVal Section As String, _
   ByVal Key As String, _
   ByVal Setting As String _
)

Paramètres

AppName
Requis. Expression String contenant le nom de l'application ou du projet auquel s'applique le paramètre.
Section
Requis. Expression String contenant le nom de la section dans laquelle le paramètre de clé est enregistré.
Key
Requis. Expression String contenant le nom du paramètre de clé enregistré.
Setting
Requis. Expression contenant la valeur définie pour Key.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	La clé du Registre n'a pas pu être créée ou 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 non structurée des erreurs. (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'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La fonction SaveSetting ajoute la clé à HKEY_CURRENT_USER\Software\VB and VBA Program Settings.

Si le paramètre de clé ne peut pas être enregistré pour une raison quelconque, une erreur se produit.

SaveSetting 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.

SaveSetting requiert l'autorisation Registre Write et Create.

Exemple

L'exemple suivant utilise d'abord la fonction 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.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")