Interaction.GetSetting(String, String, String, String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí hodnotu nastavení klíče ze položky aplikace v registru Windows. Funkce My
poskytuje vyšší produktivitu a výkon v operacích registru než GetAllSettings
. Další informace najdete v tématu 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
Parametry
- AppName
- String
Požadovaný.
String
výraz obsahující název aplikace nebo projektu, jehož klíčové nastavení je požadováno.
- Section
- String
Požadovaný.
String
výraz obsahující název oddílu, ve kterém se nachází nastavení klíče.
- Key
- String
Požadovaný.
String
výraz obsahující název nastavení klíče, který se má vrátit.
- Default
- String
Volitelný. Výraz obsahující hodnotu, která se má vrátit, pokud není v nastavení Key
nastavena žádná hodnota. Pokud tento parametr vynecháte, Default
se předpokládá, že se jedná o řetězec nulové délky ("").
Návraty
Hodnota nastavení klíče z položky aplikace v registru Windows.
Funkce My
poskytuje vyšší produktivitu a výkon v operacích registru než GetAllSettings
.
- Atributy
Výjimky
Jeden nebo více argumentů nejsou String
výrazy nebo uživatel není přihlášený.
Příklady
Tento příklad nejprve používá funkci SaveSetting
k vytvoření položek v registru Systému Windows pro aplikaci určenou jako AppName
a pak pomocí funkce GetSetting
zobrazí jedno z nastavení. Protože je zadaný argument Default
, je zaručeno vrácení určité hodnoty. Všimněte si, že Section
názvy nelze načíst pomocí GetSetting
. Nakonec funkce DeleteSetting
odebere všechny položky aplikace.
' 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")
Poznámky
Pokud některé z položek pojmenovaných v argumentech GetSetting
neexistují, GetSetting
vrátí hodnotu Default
.
Protože funguje pod klíčem registru HKEY_LOCAL_USER
, který není aktivní, dokud se uživatel neaktivuje interaktivně, GetSetting
vyžaduje přihlášení uživatele.
Nastavení registru, ke kterým se má přistupovat z neinteraktivního procesu (například Mtx.exe), by se měla ukládat v rámci HKEY_LOCAL_MACHINE\Software\
nebo klíčů registru HKEY_USER\DEFAULT\Software
.
GetSetting
vyžaduje Read
RegistryPermission.