Interaction.GetSetting(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.
Retourne une valeur de paramètre de clé à partir de l'entrée d'une application dans le registre Windows. La My fonctionnalité vous offre une productivité et des performances plus élevées dans les opérations de Registre que GetAllSettings. Pour plus d’informations, consultez Registry.
public static string GetSetting(string AppName, string Section, string Key, string Default = "");
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
Required.
String expression contenant le nom de l’application ou du projet dont le paramètre de clé est demandé.
- Section
- String
Required.
String expression contenant le nom de la section dans laquelle le paramètre de clé est trouvé.
- Key
- String
Required.
String expression contenant le nom du paramètre de clé à retourner.
- Default
- String
Optional. Expression contenant la valeur à retourner si aucune valeur n’est définie dans le Key paramètre. S’il est omis, Default il est supposé être une chaîne de longueur nulle (« »).
Retours
Valeur de paramètre de clé à partir de l'entrée d'une application dans le Registre Windows.
La My fonctionnalité vous offre une productivité et des performances plus élevées dans les opérations de Registre que GetAllSettings.
Exceptions
Un ou plusieurs arguments ne sont pas String des expressions, ou l’utilisateur n’est pas connecté.
Exemples
Cet exemple utilise d’abord la fonction SaveSetting pour créer des entrées dans le registre Windows pour l’application spécifiée comme AppName, puis utilise la fonction GetSetting pour afficher l’un des paramètres. Étant donné que l’argument Default est spécifié, une valeur est garantie d’être retournée. Notez que les Section 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 GetSetting arguments n’existe pas, GetSetting retourne une valeur de Default.
Étant donné qu’elle 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 de Registre accessibles à partir d’un processus non interactif (par exemple, Mtx.exe) doivent être stockés sous les clés de Registre ou sous HKEY_LOCAL_MACHINE\Software\ les clés de HKEY_USER\DEFAULT\Software Registre.
GetSetting nécessite ReadRegistryPermission.