Interaction.GetSetting(String, String, String, String) Méthode

Définition

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? GetSetting (string AppName, string Section, string Key, string? Default = "");
public static string GetSetting (string AppName, string Section, string Key, string Default = "");
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetSetting : string * string * string * string -> string
static member GetSetting : string * string * string * string -> string
Public Function GetSetting (AppName As String, Section As String, Key As String, Optional Default As String = "") As String

Paramètres

AppName
String

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

Section
String

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

Key
String

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

Default
String

Optionnel. 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 ("").

Retours

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.

Attributs

Exceptions

Au moins un argument n'est pas une expression String ou l'utilisateur n'est pas connecté.

Exemples

Cet exemple utilise d’abord la SaveSetting fonction pour créer des entrées dans le Registre Windows pour l’application spécifiée sous la forme AppName, puis utilise la GetSetting fonction pour afficher l’un des paramètres. Étant donné que l’argument Default est spécifié, le retour d’une valeur est garanti. Notez que Section les noms ne peuvent pas être récupérés avec GetSetting. Enfin, la DeleteSetting fonction 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")

Remarques

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

Étant donné qu’il fonctionne sous la clé de HKEY_LOCAL_USER Registre, qui n’est pas active tant qu’un utilisateur ne se connecte pas de manière interactive, GetSetting il faut qu’un utilisateur soit connecté.

Les paramètres du Registre qui doivent être accessibles à partir d’un processus non interactif (comme Mtx.exe) doivent être stockés sous les HKEY_USER\DEFAULT\Software clés de HKEY_LOCAL_MACHINE\Software\ Registre ou .

GetSetting nécessite ReadRegistryPermission.

S’applique à

Voir aussi