Interaction.DeleteSetting(String, String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Удаляет раздел или настройку параметра из записи приложения в реестре Windows. Возможность My предоставляет большую производительность и быстродействие в операциях с реестром, чем функция DeleteSetting. Дополнительные сведения см. в разделе Registry.
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void DeleteSetting (string AppName, string? Section = default, string? Key = default);public static void DeleteSetting (string AppName, string Section = default, string Key = default);[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member DeleteSetting : string * string * string -> unitstatic 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
Необязательный элемент. Выражение типа 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 реестра или .
