Interaction.DeleteSetting メソッド

.NET Framework クラス ライブラリ リファレンス

Interaction.DeleteSetting メソッド

Windows レジストリのアプリケーションのエントリから、セクションやキーの設定を削除します。My 機能を使用すると、DeleteSetting 関数を使用した場合よりも生産性とパフォーマンスが向上します。詳細については、「My.Computer.Registry オブジェクト」を参照してください。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub DeleteSetting
 ( _
    AppName As String, _
    <OptionalAttribute> Optional Section As
 String = Nothing, _
    <OptionalAttribute> Optional Key As
 String = Nothing _
)

Visual Basic (使用法)

Dim AppName As String
Dim Section As String
Dim Key As String

Interaction.DeleteSetting(AppName, Section, Key)

C#

public static void DeleteSetting
 (
    string AppName,
    [OptionalAttribute] string Section,
    [OptionalAttribute] string Key
)

C++

public:
static void DeleteSetting (
    String^ AppName, 
    [OptionalAttribute] String^ Section, 
    [OptionalAttribute] String^ Key
)

J#

public static void DeleteSetting
 (
    String AppName, 
    /** @attribute OptionalAttribute() */ String Section, 
    /** @attribute OptionalAttribute() */ String Key
)

JScript

public static function DeleteSetting
 (
    AppName : String, 
    Section : String, 
    Key : String
)

パラメータ

AppName

必須。セクションまたはキーの設定を適用するアプリケーションの名前あるいはプロジェクトの名前が含まれている String 式です。

Section

必須。キーの設定を削除するセクションの名前を含む String 式です。AppName と Section のみを指定した場合、指定したセクションとそれに関連するキー設定がすべて削除されます。

Key

省略可能。削除するキー設定の名前を含む String 式です。

解説

詳細については、Visual Basic のトピック「DeleteSetting 関数」を参照してください。

すべての引数を指定した場合、指定した設定が削除されます。存在しないセクションまたはキーの設定に対して DeleteSetting を使用しようとすると、ランタイム エラーが発生します。

DeleteSetting を使用するには、ユーザーがログオンしている必要があります。この機能の動作に使用される HKEY_LOCAL_USER レジストリ キーが、ユーザーが対話形式でログオンするまでアクティブにならないためです。

対話形式でないプロセス (Mtx.exe など) からアクセスされるレジストリ設定は、HKEY_LOCAL_MACHINE\Software\ レジストリ キーまたは HKEY_USER\DEFAULT\Software レジストリ キーの下に保存する必要があります。

使用例

次に示す例では、まず SaveSetting プロシージャを使用して Windows レジストリに MyApp アプリケーションのエントリを作成した後、DeleteSetting 関数を使用してそのエントリを削除します。Key 引数は指定されていないため、Startup セクションのセクション名とそのキーすべてを含め、このセクション全体が削除されます。

Visual Basic

' 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")

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Interaction クラス
Interaction メンバ
Microsoft.VisualBasic 名前空間
ArgumentException Class
その他の技術情報
DeleteSetting 関数
GetAllSettings 関数
GetSetting 関数
SaveSetting 関数