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

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic
Zestaw:
Microsoft.VisualBasic.dll

Zwraca wartość ustawienia klucza z wpisu aplikacji w rejestrze Windows. Ta My funkcja zapewnia większą produktywność i wydajność w operacjach rejestru niż GetAllSettings. Aby uzyskać więcej informacji, zobacz Registry.

public static string GetSetting(string AppName, string Section, string Key, string Default = "");
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

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

Section
String

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

Key
String

To jest wymagane. String wyrażenie zawierające nazwę ustawienia klucza, które ma być zwracane.

Default
String

Optional. Wyrażenie zawierające wartość, która ma być zwracana, jeśli w ustawieniu Key nie ustawiono żadnej wartości. Jeśli pominięto, przyjmuje się, Default że jest to ciąg o zerowej długości ("").

Zwraca

String

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

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

Wyjątki

ArgumentException

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

Przykłady

W tym przykładzie najpierw użyto funkcji SaveSetting do wpisów w rejestrze Windows dla aplikacji określonej jako AppName, a następnie używa funkcji GetSetting do wyświetlenia jednego z ustawień. Default Ponieważ argument jest określony, pewna wartość jest gwarantowana do zwrócenia. Zwróć uwagę, ż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 w ramach HKEY_LOCAL_USER 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ż