RegistryKey.DeleteSubKeyTree メソッド

定義

名前空間:
Microsoft.Win32
アセンブリ:
Microsoft.Win32.Registry.dll
アセンブリ:
mscorlib.dll
パッケージ:
Microsoft.Win32.Registry v5.0.0

サブキーと子サブキーを再帰的に削除します。省略可能な例外処理を使用します。

オーバーロード

名前 説明
DeleteSubKeyTree(String, Boolean)

指定したサブキーと子サブキーを再帰的に削除し、サブキーが見つからない場合に例外が発生するかどうかを指定します。
DeleteSubKeyTree(String)

サブキーと子サブキーを再帰的に削除します。

DeleteSubKeyTree(String, Boolean)

ソース:
RegistryKey.cs

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

public:
 void DeleteSubKeyTree(System::String ^ subkey, bool throwOnMissingSubKey);
public void DeleteSubKeyTree(string subkey, bool throwOnMissingSubKey);
[System.Runtime.InteropServices.ComVisible(false)]
public void DeleteSubKeyTree(string subkey, bool throwOnMissingSubKey);
member this.DeleteSubKeyTree : string * bool -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DeleteSubKeyTree : string * bool -> unit
Public Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)

パラメーター

subkey
String

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

throwOnMissingSubKey
Boolean

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

属性
ComVisibleAttribute

例外

ArgumentException

ツリーのルート ハイブを削除しようとしました。

-又は-

subkey は有効なレジストリ サブキーを指定せず、 throwOnMissingSubKey が true。

ArgumentNullException

subkey は nullです。

ObjectDisposedException

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

UnauthorizedAccessException

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

SecurityException

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

適用対象

DeleteSubKeyTree(String)

ソース:
RegistryKey.cs

サブキーと子サブキーを再帰的に削除します。

public:
 void DeleteSubKeyTree(System::String ^ subkey);
public void DeleteSubKeyTree(string subkey);
member this.DeleteSubKeyTree : string -> unit
Public Sub DeleteSubKeyTree (subkey As String)

パラメーター

subkey
String

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

例外

ArgumentNullException

subkey は nullです。

ArgumentException

ルート ハイブの削除が試行されます。

-又は-

subkey は有効なレジストリ サブキーを指定しません。

IOException

I/O エラーが発生しました。

SecurityException

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

ObjectDisposedException

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

UnauthorizedAccessException

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

例

このコード例は、 RegistryKey クラスに提供されるより大きな例の一部です。

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

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

' 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

注釈

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

Caution

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

こちらもご覧ください

適用対象