Функция SaveSetting

Статья
11/05/2008

Обновлен: Ноябрь 2007

Сохраняет или создает запись приложения в реестре Windows.

Свойство My предоставляет большую производительность и быстродействие при работе с реестром, чем SaveSetting. Дополнительные сведения см. в разделе Объект My.Computer.Registry.

Public Sub SaveSetting( _
   ByVal AppName As String, _ 
   ByVal Section As String, _
   ByVal Key As String, _
   ByVal Setting As String _
)

Параметры

AppName
Требуется. Выражение String, содержащее имя приложения или проекта, к которому применяется параметр.
Section
Требуется. Выражение String, содержащее имя раздела, в котором был сохранен параметр ключа.
Key
Требуется. Выражение String, содержащее имя параметра ключа, которое следует сохранить.
Setting
Требуется. Выражение, содержащее значение, которое задается для параметра Key.

Исключения

Тип исключения	Номер ошибки	Условие
ArgumentException	5	Реестр ключа не может быть создан, или пользователь не выполнил вход в систему.

См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако по возможности следует заменять такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.

Заметки

Функция SaveSetting добавляет ключ к HKEY_CURRENT_USER\Software\VB and VBA Program Settings.

Если параметры ключа по какой-либо причине не могут быть сохранены, возникает ошибка.

Для использования SaveSetting необходимо войти в систему, так как эта функция работает с ключом реестра HKEY_LOCAL_USER, который активируется только при интерактивном входе пользователя в систему.

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

SaveSetting требует Write и Createразрешения реестра.

Пример

В следующем примере сначала используется функция SaveSetting, чтобы создать записи в реестре Windows для приложения MyApp, а затем функция DeleteSetting, чтобы удалить их.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")