RegistryKey.DeleteSubKey メソッド

  • リファレンス

定義

名前空間:
Microsoft.Win32
アセンブリ:
Microsoft.Win32.Registry.dll
アセンブリ:
mscorlib.dll

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

オーバーロード

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 であり、指定したサブキーが見つからない場合は、何も実行されません。

例外

InvalidOperationException

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

ArgumentException

subkey に有効なレジストリ キーが指定されておらず、throwOnMissingSubKey が true です。

ArgumentNullException

subkey が nullです。

SecurityException

ユーザーに、キーの削除に必要なアクセス許可がありません。

ObjectDisposedException

操作対象の RegistryKey が閉じています。閉じられたキーにはアクセスできません。

UnauthorizedAccessException

ユーザーに、必要なレジストリ権限がありません。

注釈

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

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

こちらもご覧ください

適用対象