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)