RegistryKey.DeleteSubKeyTree メソッド

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

RegistryKey.DeleteSubKeyTree メソッド

サブキーとその子サブキーを再帰的に削除します。文字列 subkey では、大文字と小文字は区別されません。

名前空間: Microsoft.Win32
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub DeleteSubKeyTree ( _
    subkey As String _
)

Visual Basic (使用法)

Dim instance As RegistryKey
Dim subkey As String

instance.DeleteSubKeyTree(subkey)

C#

public void DeleteSubKeyTree (
    string subkey
)

C++

public:
void DeleteSubKeyTree (
    String^ subkey
)

J#

public void DeleteSubKeyTree (
    String subkey
)

JScript

public function DeleteSubKeyTree (
    subkey : String
)

パラメータ

subkey

削除するサブキー。

例外

例外の種類	条件
ArgumentNullException	subkey が null 参照 (Visual Basic では Nothing) です。
ArgumentException	ルート ハイブを削除しようとしました。 または subkey に、有効なレジストリ サブキーが指定されていません。
SecurityException	ユーザーに、キーの削除に必要なアクセス許可がありません。
ObjectDisposedException	操作対象の RegistryKey が閉じています。閉じられたキーにはアクセスできません。
UnauthorizedAccessException	ユーザーに、必要なレジストリ権限がありません。

解説

サブキーとそのツリーを削除するための適切なアクセス許可が必要です。

注意
特定のキーを削除すると、ツリー内のそのキーの下にあるすべてのエントリも削除されます。警告は表示されません。子サブキーのないサブキーだけを削除するには、DeleteSubKey メソッドを使用します。

使用例

このコード例は、RegistryKey クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Delete or close the new subkey.
Console.Write(vbCrLf & "Delete newly created "
 & _
    "registry key? (Y/N) ")
If Char.ToUpper(Convert.ToChar(Console.Read()))
 = "Y"C Then
    Registry.CurrentUser.DeleteSubKeyTree("Test9999")
    Console.WriteLine(vbCrLf & "Registry key {0} deleted.",
 _
        test9999.Name)
Else
    Console.WriteLine(vbCrLf & "Registry key {0} closed.",
 _
        test9999.ToString())
    test9999.Close()
End If

C#

// Delete or close the new subkey.
Console.Write("\nDelete newly created registry key? (Y/N) ");
if(Char.ToUpper(Convert.ToChar(Console.Read())) == 'Y')
{
    Registry.CurrentUser.DeleteSubKeyTree("Test9999");
    Console.WriteLine("\nRegistry key {0} deleted.", 
        test9999.Name);
}
else
{
    Console.WriteLine("\nRegistry key {0} closed.", 
        test9999.ToString());
    test9999.Close();
}

C++

// Delete or close the new subkey.
Console::Write( "\nDelete newly created registry key? (Y/N) " );
if ( Char::ToUpper( Convert::ToChar( Console::Read() ) ) == 'Y'
 )
{
   Registry::CurrentUser->DeleteSubKeyTree( "Test9999" );
   Console::WriteLine( "\nRegistry key {0} deleted.", test9999->Name
 );
}
else
{
   Console::WriteLine( "\nRegistry key {0} closed.", test9999->ToString()
 );
   test9999->Close();
}

.NET Framework のセキュリティ

• RegistryPermission  (指定したレジストリ キーを変更するために必要なアクセス許可)。RegistryPermissionAccess.Write (関連する列挙体)
• SecurityPermission  (指定したレジストリ キーがリモート キーである場合にこのレジストリ キーにアクセスするために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
RegistryKey クラス
RegistryKey メンバ
Microsoft.Win32 名前空間
DeleteSubKey
CreateSubKey
DeleteValue
GetSubKeyNames
SubKeyCount