Поделиться через


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 -> unit
static member DeleteSetting : string * string * string -> unit
Public 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 реестра или .

Применяется к

См. также раздел