Interaction.GetSetting(String, String, String, String) Метод

Определение

Пространство имен:
Microsoft.VisualBasic
Сборка:
Microsoft.VisualBasic.dll

Возвращает значение параметра ключа из записи приложения в реестре Windows. Эта My функция обеспечивает большую производительность и производительность в операциях реестра, чем GetAllSettings. Дополнительные сведения см. в разделе 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

Параметры

AppName
String

Обязательно. String выражение, содержащее имя приложения или проекта, параметр ключа которого запрашивается.

Section
String

Обязательно. String выражение, содержащее имя раздела, в котором найден параметр ключа.

Key
String

Обязательно. String выражение, содержащее имя возвращаемого параметра ключа.

Default
String

Optional. Выражение, содержащее значение, возвращаемое, если значение не задано в параметре Key . Если опущено, предполагается, Default что строка нулевой длины ("").

Возвращаемое значение

String

Значение параметра ключа из записи приложения в реестре Windows.

Эта My функция обеспечивает большую производительность и производительность в операциях реестра, чем GetAllSettings.

Исключения

ArgumentException

Один или несколько аргументов не String являются выражениями, или пользователь не входит в систему.

Примеры

В этом примере сначала используется функция SaveSetting для записи в реестре Windows для приложения, указанного как AppName, а затем использует функцию GetSetting для отображения одного из параметров. Default Так как аргумент указан, некоторые значения гарантированно возвращаются. Обратите внимание, что Section имена нельзя извлечь с GetSettingпомощью . Наконец, DeleteSetting функция удаляет все записи приложения.

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

Комментарии

Если ни один из элементов, именованных в GetSetting аргументах, не существует, GetSetting возвращает значение Default.

Так как он работает под разделом HKEY_LOCAL_USER реестра, который не активен, пока пользователь не войдет в систему в интерактивном режиме, GetSetting требует, чтобы пользователь вошел в систему.

Параметры реестра, к которым необходимо получить доступ из неинтерактивного процесса (например, Mtx.exe) должны храниться в HKEY_LOCAL_MACHINE\Software\ разделах реестра или в HKEY_USER\DEFAULT\Software разделах реестра.

GetSetting требуется ReadRegistryPermission.

Применяется к

См. также раздел