Interaction.SaveSetting, méthode

Article
08/21/2007

Enregistre ou crée une entrée d'application d'entrée dans la base de registres Windows. L'utilisation de 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.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Sub SaveSetting ( _
    AppName As String, _
    Section As String, _
    Key As String, _
    Setting As String _
)
'Utilisation
Dim AppName As String
Dim Section As String
Dim Key As String
Dim Setting As String

Interaction.SaveSetting(AppName, Section, Key, Setting)

public static void SaveSetting (
    string AppName,
    string Section,
    string Key,
    string Setting
)

public:
static void SaveSetting (
    String^ AppName, 
    String^ Section, 
    String^ Key, 
    String^ Setting
)

public static void SaveSetting (
    String AppName, 
    String Section, 
    String Key, 
    String Setting
)

public static function SaveSetting (
    AppName : String, 
    Section : String, 
    Key : String, 
    Setting : String
)

Paramètres

AppName
Obligatoire. Expression String contenant le nom de l'application ou du projet auquel le paramètre s'applique.

Section
Obligatoire. Expression String contenant le nom de la section dans laquelle le paramètre de clé est enregistré.

Key
Obligatoire. Expression String contenant le nom du paramètre de clé enregistré.

Setting
Obligatoire. Expression contenant la valeur avec laquelle Key est définie.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic SaveSetting, fonction.

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 du Registre accessibles à partir d'un processus non interactif (tel que mtx.exe) doivent être stockés sous la clé de Registre HKEY_LOCAL_MACHINE\Software\ ou HKEY_USER\DEFAULT\Software.

SaveSetting requiert l'autorisation RegistreWrite et Create.

Exemple

L'exemple suivant utilise d'abord la fonction SaveSetting pour entrer des données dans la base de registres 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")

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

Interaction, classe
Membres Interaction
Microsoft.VisualBasic, espace de noms
RegistryPermission Class

Autres ressources

SaveSetting, fonction
DeleteSetting, fonction
GetAllSettings, fonction
GetSetting, fonction
Tâches courantes relatives au Registre

Partager via