RegistryKey.DeleteSubKeyTree 方法

定義

命名空間:

Microsoft.Win32

組件:

Microsoft.Win32.Registry.dll

透過選擇性例外狀況處理，遞迴地刪除子機碼和任何子系子機碼。

多載

DeleteSubKeyTree(String, Boolean)	遞迴地刪除指定的子機碼和任何子系子機碼，並且指定在找不到該子機碼時是否引發例外狀況。
DeleteSubKeyTree(String)	遞迴地刪除子機碼和任何子系子機碼。

DeleteSubKeyTree(String, Boolean)

遞迴地刪除指定的子機碼和任何子系子機碼，並且指定在找不到該子機碼時是否引發例外狀況。

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

public void DeleteSubKeyTree (string subkey, bool throwOnMissingSubKey);

member this.DeleteSubKeyTree : string * bool -> unit

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

參數

subkey

String

要刪除的子機碼名稱。 這個字串不會區分大小寫。

throwOnMissingSubKey

Boolean

表示如果找不到指定子機碼時，是否引發例外狀況。 如果這個引數為 true，而指定的子機碼不存在時，則會引發例外狀況。 如果這個引數為 false，而指定的子機碼不存在時，則不採取任何動作。

例外狀況

ArgumentException

嘗試刪除樹狀目錄的根登錄區。

-或-

subkey 沒有指定有效的登錄子機碼，而且 throwOnMissingSubKey 為 true。

ArgumentNullException

subkey 為 null。

ObjectDisposedException

RegistryKey 已經關閉 (關閉的機碼無法存取)。

UnauthorizedAccessException

使用者沒有必要的登錄權限。

SecurityException

使用者沒有刪除機碼所需的使用權限。

DeleteSubKeyTree(String)

遞迴地刪除子機碼和任何子系子機碼。

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

備註

您必須具有適當的許可權，才能刪除子機碼及其樹狀目錄。

警告

刪除特定索引鍵將會移除樹狀結構中索引鍵下方的所有專案。 將不會提供警告。 如果您只想在子機碼沒有子機碼時刪除子機碼，請使用 DeleteSubKey 方法。

另請參閱

• DeleteSubKey(String)
• CreateSubKey(String)
• DeleteValue(String)
• GetSubKeyNames()
• SubKeyCount