RegistryKey.DeleteSubKeyTree メソッドとは何？わかりやすく解説 Weblio辞書

.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)

public void DeleteSubKeyTree (
    string subkey
)

C++

public:
void DeleteSubKeyTree (
    String^ subkey
)

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

// 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();
}