Udostępnij za pośrednictwem


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

Definicja

Zwraca wartość ustawienia klucza z wpisu aplikacji w rejestrze systemu Windows. Funkcja My zapewnia większą produktywność i wydajność operacji rejestru niż GetAllSettings. Aby uzyskać więcej informacji, zobacz 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

Wymagane. String wyrażenie zawierające nazwę aplikacji lub projektu, którego ustawienie klucza jest żądane.

Section
String

Wymagane. String wyrażenie zawierające nazwę sekcji, w której znaleziono ustawienie klucza.

Key
String

Wymagane. String wyrażenie zawierające nazwę ustawienia klucza do zwrócenia.

Default
String

Fakultatywny. Wyrażenie zawierające wartość do zwrócenia, jeśli w ustawieniu Key nie ustawiono żadnej wartości. W przypadku pominięcia przyjmuje się, że Default jest ciągiem o zerowej długości ("").

Zwraca

Wartość ustawienia klucza z wpisu aplikacji w rejestrze systemu Windows.

Funkcja My zapewnia większą produktywność i wydajność operacji rejestru niż GetAllSettings.

Atrybuty

Wyjątki

Co najmniej jeden argument nie jest String wyrażeń lub użytkownik nie jest zalogowany.

Przykłady

W tym przykładzie najpierw użyto funkcji SaveSetting do tworzenia wpisów w rejestrze systemu Windows dla aplikacji określonej jako AppName, a następnie używa funkcji GetSetting do wyświetlenia jednego z ustawień. Ponieważ określono argument Default, należy zwrócić pewną wartość. Zwróć uwagę, że nie można pobrać nazw Section z GetSetting. Na koniec funkcja DeleteSetting usuwa wszystkie wpisy aplikacji.

' 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")

Uwagi

Jeśli którykolwiek z elementów o nazwie w argumentach GetSetting nie istnieje, GetSetting zwraca wartość Default.

Ponieważ działa w ramach klucza rejestru HKEY_LOCAL_USER, który nie jest aktywny, dopóki użytkownik nie zaloguje się interaktywnie, GetSetting wymaga zalogowania użytkownika.

Ustawienia rejestru, które mają być dostępne z poziomu nieinterakcyjnego procesu (takiego jak Mtx.exe), powinny być przechowywane w HKEY_LOCAL_MACHINE\Software\ lub kluczach rejestru HKEY_USER\DEFAULT\Software.

GetSetting wymaga ReadRegistryPermission.

Dotyczy

Zobacz też