RegistryKey.DeleteSubKeyTree Metode

Definisi

Ruang nama:

Microsoft.Win32

Rakitan:

Microsoft.Win32.Registry.dll

Menghapus subkuntang dan subkunjung turunan secara rekursif, dengan penanganan pengecualian opsional.

Overload

DeleteSubKeyTree(String, Boolean)	Menghapus subkunjung yang ditentukan dan subkunjung turunan secara rekursif, dan menentukan apakah pengecualian dimunculkan jika subkunjung tidak ditemukan.
DeleteSubKeyTree(String)	Menghapus subkuntang dan subkuntang anak apa pun secara rekursif.

DeleteSubKeyTree(String, Boolean)

Menghapus subkunjung yang ditentukan dan subkunjung turunan secara rekursif, dan menentukan apakah pengecualian dimunculkan jika subkunjung tidak ditemukan.

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)

Parameter

subkey

String

Nama subkunjuk yang akan dihapus. String ini tidak peka huruf besar/kecil.

throwOnMissingSubKey

Boolean

Menunjukkan apakah pengecualian harus dinaikkan jika subkunjung yang ditentukan tidak dapat ditemukan. Jika argumen ini adalah true dan subkunjung yang ditentukan tidak ada, pengecualian akan dimunculkan. Jika argumen ini adalah false dan subkuntah yang ditentukan tidak ada, tidak ada tindakan yang diambil.

Pengecualian

ArgumentException

Upaya dilakukan untuk menghapus sarang akar pohon.

-atau-

subkey tidak menentukan subkunci registri yang valid, dan throwOnMissingSubKey adalah true.

ArgumentNullException

subkeyadalah null.

ObjectDisposedException

RegistryKey ditutup (kunci tertutup tidak dapat diakses).

UnauthorizedAccessException

Pengguna tidak memiliki hak registri yang diperlukan.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk menghapus kunci.

DeleteSubKeyTree(String)

Menghapus subkuntang dan subkuntang anak apa pun secara rekursif.

public:
 void DeleteSubKeyTree(System::String ^ subkey);

public void DeleteSubKeyTree (string subkey);

member this.DeleteSubKeyTree : string -> unit

Public Sub DeleteSubKeyTree (subkey As String)

Parameter

subkey

String

Sub-kunci yang akan dihapus. String ini tidak peka huruf besar/kecil.

Pengecualian

ArgumentNullException

subkeyadalah null.

ArgumentException

Penghapusan sarang akar dicoba.

-atau-

subkey tidak menentukan subkunci registri yang valid.

IOException

Terjadi kesalahan I/O.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk menghapus kunci.

ObjectDisposedException

Yang RegistryKey sedang dimanipulasi ditutup (kunci tertutup tidak dapat diakses).

UnauthorizedAccessException

Pengguna tidak memiliki hak registri yang diperlukan.

Contoh

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk RegistryKey kelas .

// 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

Keterangan

Anda harus memiliki izin yang sesuai untuk menghapus sub-kunci dan pohonnya.

Perhatian

Menghapus kunci tertentu akan menghapus semua entri di bawah kunci di pohon. Tidak ada peringatan yang akan diberikan. Jika Anda ingin menghapus subkey hanya ketika tidak memiliki subkey anak, gunakan metode .DeleteSubKey

Lihat juga

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