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

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

Interaction.vb

Возвращает значение параметра ключа из записи приложения в реестре Windows. Функция My обеспечивает большую производительность и производительность в операциях реестра, чем GetAllSettings. Дополнительные сведения см. в Registry.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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

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 предполагается, что строка нулевой длины ("").

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

String

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

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

Атрибуты

SupportedOSPlatformAttribute

Исключения

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.

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

• DeleteSetting(String, String, String)
• GetAllSettings(String, String)
• SaveSetting(String, String, String, String)
• ArgumentException
• RegistryPermission
• чтение и запись в реестр (Visual Basic)