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

Définition

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.

S’applique à

Voir aussi