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

Definicja

Zwraca wartość ustawienia klucza z wpisu aplikacji w rejestrze systemu Windows. Ta My funkcja zapewnia większą produktywność i wydajność w operacjach 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 wymagane.

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

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

Zwraca

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

Ta My funkcja zapewnia większą produktywność i wydajność w operacjach rejestru niż GetAllSettings.

Atrybuty

Wyjątki

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

Przykłady

W tym przykładzie najpierw użyto SaveSetting funkcji do tworzenia wpisów w rejestrze systemu Windows dla aplikacji określonej jako AppName, a następnie używa GetSetting funkcji do wyświetlenia jednego z ustawień. Default Ponieważ argument jest określony, należy zwrócić pewną wartość. Zauważ, że Section nie można pobrać nazw za pomocą polecenia GetSetting. DeleteSetting Na koniec funkcja 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 GetSetting argumentach nie istnieje, GetSetting zwraca wartość Default.

Ponieważ działa on w HKEY_LOCAL_USER ramach klucza rejestru, 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 (na przykład Mtx.exe), powinny być przechowywane w ramach HKEY_LOCAL_MACHINE\Software\ kluczy rejestru lub HKEY_USER\DEFAULT\Software .

GetSettingwymaga .ReadRegistryPermission

Dotyczy

Zobacz też