Interaction.SaveSetting(String, 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.
Enregistre ou crée une entrée d’application dans le Registre Windows. La fonctionnalité My
vous offre une productivité et des performances supérieures à SaveSetting
. Pour plus d’informations, consultez Registry.
public:
static void SaveSetting(System::String ^ AppName, System::String ^ Section, System::String ^ Key, System::String ^ Setting);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void SaveSetting (string AppName, string Section, string Key, string Setting);
public static void SaveSetting (string AppName, string Section, string Key, string Setting);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member SaveSetting : string * string * string * string -> unit
static member SaveSetting : string * string * string * string -> unit
Public Sub SaveSetting (AppName As String, Section As String, Key As String, Setting As String)
Paramètres
- AppName
- String
Obligatoire.
String
expression contenant le nom de l’application ou du projet auquel le paramètre s’applique.
- Section
- String
Obligatoire.
String
expression contenant le nom de la section dans laquelle le paramètre de clé est enregistré.
- Key
- String
Obligatoire.
String
expression contenant le nom du paramètre de clé en cours d’enregistrement.
- Setting
- String
Obligatoire. Expression contenant la valeur à laquelle Key
est définie.
- Attributs
Exceptions
Impossible de créer le Registre de clés ou l’utilisateur n’est pas connecté.
Exemples
L’exemple suivant utilise d’abord la fonction SaveSetting
pour effectuer des entrées dans le Registre 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")
Remarques
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
exige qu’un utilisateur soit connecté, car il fonctionne sous la clé de Registre HKEY_LOCAL_USER
, qui n’est pas active tant qu’un utilisateur ne se connecte pas de manière interactive.
Les paramètres de Registre à accéder à partir d’un processus non interactif (par exemple, Mtx.exe) doivent être stockés sous les clés de Registre HKEY_LOCAL_MACHINE\Software\
ou HKEY_USER\DEFAULT\Software
.
SaveSetting
nécessite Write
et Create
RegistryPermission.