Interaction.GetSetting, méthode

Article
08/21/2007

Retourne une valeur de paramètre de clé pour une application 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 GetAllSettings. 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 Function GetSetting ( _
    AppName As String, _
    Section As String, _
    Key As String, _
    <OptionalAttribute> Optional Default As String = "" _
) As String
'Utilisation
Dim AppName As String
Dim Section As String
Dim Key As String
Dim Default As String
Dim returnValue As String

returnValue = Interaction.GetSetting(AppName, Section, Key, Default)

public static string GetSetting (
    string AppName,
    string Section,
    string Key,
    [OptionalAttribute] string Default
)

public:
static String^ GetSetting (
    String^ AppName, 
    String^ Section, 
    String^ Key, 
    [OptionalAttribute] String^ Default
)

public static String GetSetting (
    String AppName, 
    String Section, 
    String Key, 
    /** @attribute OptionalAttribute() */ String Default
)

public static function GetSetting (
    AppName : String, 
    Section : String, 
    Key : String, 
    Default : String
) : String

Paramètres

AppName
Obligatoire. Expression String contenant le nom de l'application ou du projet dont le paramètre de clé est demandé.

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

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

Default
Facultatif. Expression contenant la valeur à retourner si aucune valeur n'est définie dans le paramètre Key. S'il est omis, Default est considéré comme une chaîne de longueur nulle ("").

Valeur de retour

Notes

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

Si l'un des éléments nommés dans les arguments GetSetting n'existe pas, GetSetting retourne la valeur Default.

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

GetSetting nécessite l'autorisation RegistreRead.

Exemple

Cet exemple utilise d'abord la fonction SaveSetting pour entrer des données dans la base de registres Windows pour l'application spécifiée en tant qu'argument AppName, puis utilise la fonction GetSetting pour afficher les paramètres. Dans la mesure où l'argument Default est spécifié, le retour d'une valeur est garanti. Notez que les noms de Section ne peuvent pas être récupérés par GetSetting. Enfin, la fonction DeleteSetting supprime toutes les entrées de l'application.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
Console.WriteLine(GetSetting("MyApp", "Startup", "Left", "25"))
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
ArgumentException Class
RegistryPermission Class

Autres ressources

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

Partager via