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é 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 Read
RegistryPermission.
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour