Interaction.DeleteSetting(String, String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 -> unitstatic 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 使用してアプリケーションの 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 必要があります。
適用対象
こちらもご覧ください
.NET