Interaction.GetSetting(String, String, String, String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 Read
RegistryPermission.