Sdílet prostřednictvím


Interaction.GetSetting(String, String, String, String) Metoda

Definice

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 AppNamea 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 ReadRegistryPermission.

Platí pro

Viz také