次の方法で共有


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 型の式。 AppNameSection のみを指定した場合、指定したセクションとそれに関連するキー設定がすべて削除されます。

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 必要があります。

適用対象

こちらもご覧ください