Interaction.DeleteSetting(String, String, String) Метод

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

Interaction.vb

Удаляет раздел или настройку параметра из записи приложения в реестре Windows. Возможность My предоставляет большую производительность и быстродействие в операциях с реестром, чем функция DeleteSetting. Дополнительные сведения см. в разделе Registry.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void DeleteSetting (string AppName, string? Section = default, string? Key = default);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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, содержащее имя удаляемой настройки параметра.

Атрибуты

SupportedOSPlatformAttribute

Исключения

ArgumentException

Пользователь не выполнил вход в систему.

Примеры

В следующем примере сначала используется 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 реестра или .

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

• GetAllSettings(String, String)
• GetSetting(String, String, String, String)
• SaveSetting(String, String, String, String)
• ArgumentException