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