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_USER\DEFAULT\Software 登錄機碼底下HKEY_LOCAL_MACHINE\Software\。

另請參閱

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