Share via


DeleteSetting 函式

更新:2007 年 11 月

從 Windows 登錄的應用程式項目中刪除區段或機碼設定。

My 功能在登錄作業中所提供的產能和效能大於 DeleteSetting 函式。如需詳細資訊,請參閱 My.Computer.Registry 物件

Public Sub DeleteSetting( _
   ByVal AppName As String, _
   Optional ByVal Section As String = Nothing, _
   Optional ByVal Key As String = Nothing _
)

參數

  • AppName
    必要項。String 運算式,包含應用程式名稱或是區段或機碼設定所套用的專案名稱。

  • Section
    必要項。String 運算式,包含要刪除機碼設定的區段名稱。若只提供 AppName 和 Section,則會刪除指定的區段,以及所有相關的機碼設定。

  • Key
    選擇項。String 運算式,包含要刪除的機碼設定名稱。

例外狀況

例外狀況類型

錯誤代碼

條件

ArgumentException

5

Section、AppName 或 Key 設定不存在。

ArgumentException

5

使用者未登入。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級,請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是,請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

如果提供所有的引數,則只刪除指定的設定。如果您嘗試在不存在的區段或機碼設定上使用 DeleteSetting,將會發生執行階段錯誤。

因為 DeleteSetting 是在 HKEY_LOCAL_USER 登錄機碼下作業,所以它會要求使用者登入,而這個機碼要等到使用者以互動方式登入時才會作用。

要從非互動式處理序 (例如 Mtx.exe) 存取的登錄設定應該存放在 HKEY_LOCAL_MACHINE\Software\ 或 HKEY_USER\DEFAULT\Software 登錄機碼之下。

範例

下列範例會先使用 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")

智慧型裝置開發人員注意事項

不支援這個函式。

需求

命名空間:Microsoft.VisualBasic

模組:Interaction

Assembly: Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

GetAllSettings 函式

GetSetting 函式

SaveSetting 函式

ArgumentException