Interaction.DeleteSetting(String, String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Удаляет раздел или параметр ключа из записи приложения в реестре Windows. Эта My функция обеспечивает большую производительность и производительность в операциях реестра, чем DeleteSetting функция. Дополнительные сведения см. в статье Registry.
public static void DeleteSetting(string AppName, string Section = default, string Key = default);static member DeleteSetting : string * string * string -> unitPublic Sub DeleteSetting (AppName As String, Optional Section As String = Nothing, Optional Key As String = Nothing)Параметры
- AppName
- String
Обязательно.
String выражение, содержащее имя приложения или проекта, к которому применяется раздел или параметр ключа.
- Section
- String
Обязательно.
String выражение, содержащее имя раздела, из которого удаляется параметр ключа.
AppName Если только и Section предоставлено, указанный раздел удаляется вместе со всеми связанными параметрами ключа.
- Key
- String
Optional.
String выражение, содержащее имя удаленного параметра ключа.
Исключения
Пользователь не входит в систему.
Примеры
В следующем примере сначала используется процедура SaveSetting для записи в реестре Windows для приложения MyApp, а затем использует функцию DeleteSetting для их удаления. Так как аргумент не Key указан, весь Startup раздел удаляется, включая имя раздела и все его ключи.
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Remove section and all its settings from registry.
DeleteSetting("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting("MyApp")
Комментарии
Если указаны все аргументы, указанный параметр удаляется. Ошибка во время выполнения возникает, если вы пытаетесь использовать DeleteSetting в несуществующем разделе или параметре ключа.
DeleteSetting Требуется, чтобы пользователь вошел в систему, так как он работает под разделом HKEY_LOCAL_USER реестра, который не активен, пока пользователь не войдет в систему в интерактивном режиме.
Параметры реестра, к которым необходимо получить доступ из неинтерактивного процесса (например, Mtx.exe) должны храниться в HKEY_LOCAL_MACHINE\Software\ разделах реестра или в HKEY_USER\DEFAULT\Software разделах реестра.