Interaction.GetSetting(String, String, String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение параметра ключа из записи приложения в реестре Windows. Функция My
обеспечивает большую производительность и производительность в операциях реестра, чем GetAllSettings
. Дополнительные сведения см. в 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
Параметры
- AppName
- String
Обязательно.
String
выражение, содержащее имя приложения или проекта, параметр ключа которого запрашивается.
- Section
- String
Обязательно.
String
выражение, содержащее имя раздела, в котором найден параметр ключа.
- Key
- String
Обязательно.
String
выражение, содержащее имя возвращаемого параметра ключа.
- Default
- String
Необязательный. Выражение, содержащее значение, возвращаемое, если значение не задано в параметре Key
. Если опущено, Default
предполагается, что строка нулевой длины ("").
Возвращаемое значение
Значение параметра ключа из записи приложения в реестре Windows.
Функция My
обеспечивает большую производительность и производительность в операциях реестра, чем GetAllSettings
.
- Атрибуты
Исключения
Один или несколько аргументов не являются 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
требуется Read
RegistryPermission.