RegistryKey.DeleteSubKey メソッド

定義

名前空間:: Microsoft.Win32

アセンブリ:: Microsoft.Win32.Registry.dll

アセンブリ:: mscorlib.dll

パッケージ:: Microsoft.Win32.Registry v5.0.0

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定したサブキーを削除します。

オーバーロード

名前	説明
DeleteSubKey(String)	指定したサブキーを削除します。
DeleteSubKey(String, Boolean)	指定したサブキーを削除し、サブキーが見つからない場合に例外が発生するかどうかを指定します。

DeleteSubKey(String)

ソース:: RegistryKey.cs

指定したサブキーを削除します。

public:
 void DeleteSubKey(System::String ^ subkey);

public void DeleteSubKey(string subkey);

member this.DeleteSubKey : string -> unit

Public Sub DeleteSubKey (subkey As String)

パラメーター

subkey: String

削除するサブキーの名前。この文字列では大文字と小文字は区別されません。

例外

InvalidOperationException

subkeyには子サブキーがあります

ArgumentException

subkey パラメーターで有効なレジストリキーが指定されていません

ArgumentNullException

subkey は null です

SecurityException

ユーザーには、キーを削除するために必要なアクセス許可がありません。

ObjectDisposedException

操作されている RegistryKey は閉じられています (閉じたキーにはアクセスできません)。

UnauthorizedAccessException

ユーザーは必要なレジストリ権限を持っていません。

例

次の例は、DeleteSubKey の使用方法を示しています。

using namespace System;
using namespace Microsoft::Win32;

public ref class RegKeyDel
{
public:
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey^ test9999 =
            Registry::CurrentUser->CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        RegistryKey^ testName = test9999->CreateSubKey("TestName");
        RegistryKey^ testSettings = test9999->CreateSubKey("TestSettings");

        // Create data for the TestSettings subkey.
        testSettings->SetValue("Language", "French");
        testSettings->SetValue("Level", "Intermediate");
        testSettings->SetValue("ID", 123);

        // delete the subkey "TestName"
        test9999->DeleteSubKey("TestName");
        // delete everything under and including "Test9999"
        Registry::CurrentUser->DeleteSubKeyTree("Test9999");
    }
};

int main()
{
    RegKeyDel::Main();
}

using System;
using Microsoft.Win32;

class RegKeyDel
{
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey test9999 =
            Registry.CurrentUser.CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        RegistryKey testName = test9999.CreateSubKey("TestName");
        RegistryKey testSettings = test9999.CreateSubKey("TestSettings");

        // Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French");
        testSettings.SetValue("Level", "Intermediate");
        testSettings.SetValue("ID", 123);

        // delete the subkey "TestName"
        test9999.DeleteSubKey("TestName");
        // delete everything under and including "Test9999"
        Registry.CurrentUser.DeleteSubKeyTree("Test9999");
    }
}

Imports Microsoft.Win32

Public Class RegKeyDel
    Public Shared Sub Main()
        ' Create a subkey named Test9999 under HKEY_CURRENT_USER.
        Dim test9999 As RegistryKey = _
            Registry.CurrentUser.CreateSubKey("Test9999")
        ' Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        ' keys are disposed when execution exits the using statement.
        Dim testName As RegistryKey = test9999.CreateSubKey("TestName")
        Dim testSettings As RegistryKey = test9999.CreateSubKey("TestSettings")

        ' Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French")
        testSettings.SetValue("Level", "Intermediate")
        testSettings.SetValue("ID", 123)

        ' delete the subkey "TestName"
        test9999.DeleteSubKey("TestName")
        ' delete everything under and including "Test9999"
        Registry.CurrentUser.DeleteSubKeyTree("Test9999")
    End Sub
End Class

注釈

子サブキーを削除するには、 DeleteSubKeyTreeを使用します。

レジストリキーを削除するときは注意が必要です。

こちらもご覧ください

適用対象

DeleteSubKey(String, Boolean)

ソース:: RegistryKey.cs

指定したサブキーを削除し、サブキーが見つからない場合に例外が発生するかどうかを指定します。

public:
 void DeleteSubKey(System::String ^ subkey, bool throwOnMissingSubKey);

public void DeleteSubKey(string subkey, bool throwOnMissingSubKey);

member this.DeleteSubKey : string * bool -> unit

Public Sub DeleteSubKey (subkey As String, throwOnMissingSubKey As Boolean)

パラメーター

subkey: String

削除するサブキーの名前。この文字列では大文字と小文字は区別されません。

throwOnMissingSubKey: Boolean

指定したサブキーが見つからない場合に例外を発生させるかどうかを示します。この引数が true され、指定したサブキーが存在しない場合は、例外が発生します。この引数が false され、指定したサブキーが存在しない場合、アクションは実行されません。

例外