Interaction.DeleteSetting(String, String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows レジストリ内のアプリケーションのエントリからセクションまたはキー設定を削除します。
My機能を使用すると、DeleteSetting関数よりもレジストリ操作の生産性とパフォーマンスが向上します。 詳細については、「Registry」を参照してください。
public static void DeleteSetting(string AppName, string Section = default, string Key = default);static member DeleteSetting : string * string * string -> unitPublic 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 削除されるキー設定の名前を含む式。
例外
ユーザーがログインしていません。
例
次の例では、最初に SaveSetting プロシージャを使用して、MyApp アプリケーションのWindows レジストリにエントリを作成した後、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 レジストリ キーのいずれかに格納する必要があります。