Interaction.SaveSetting(String, String, String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сохраняет или создает запись приложения в реестре Windows. Возможность My
предоставляет большую производительность и быстродействие в операциях реестра, чем функция SaveSetting
. Для получения дополнительной информации см. Registry.
public:
static void SaveSetting(System::String ^ AppName, System::String ^ Section, System::String ^ Key, System::String ^ Setting);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void SaveSetting (string AppName, string Section, string Key, string Setting);
public static void SaveSetting (string AppName, string Section, string Key, string Setting);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member SaveSetting : string * string * string * string -> unit
static member SaveSetting : string * string * string * string -> unit
Public Sub SaveSetting (AppName As String, Section As String, Key As String, Setting As String)
Параметры
- AppName
- String
Обязательный. Выражение типа String
, содержащее имя приложения или проекта, в котором применяется этот параметр.
- Section
- String
Обязательный. Выражение типа String
, содержащее имя раздела, в котором сохраняется настройка параметра реестра.
- Key
- String
Обязательный. Выражение типа String
, содержащее имя сохраняемой настройки параметра реестра.
- Setting
- String
Обязательный. Выражение, содержащее значение, которое устанавливается для параметра Key
.
- Атрибуты
Исключения
Реестр ключа не может быть создан, или пользователь не выполнил вход в систему.
Примеры
В следующем примере сначала используется 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")
Комментарии
Функция 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
RegistryPermission.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по