Freigeben über

RegistryKey.DeleteSubKeyTree-Methode

Löscht einen Unterschlüssel und alle untergeordneten Unterschlüssel rekursiv. Bei der Zeichenfolge subkey wird die Groß- und Kleinschreibung nicht berücksichtigt.

Namespace: Microsoft.Win32
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub DeleteSubKeyTree ( _
    subkey As String _
)
'Usage
Dim instance As RegistryKey
Dim subkey As String

instance.DeleteSubKeyTree(subkey)

public void DeleteSubKeyTree (
    string subkey
)

public:
void DeleteSubKeyTree (
    String^ subkey
)

public void DeleteSubKeyTree (
    String subkey
)

public function DeleteSubKeyTree (
    subkey : String
)

Parameter

  • subkey
    Der zu löschende Unterschlüssel.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

subkey ist NULL (Nothing in Visual Basic).

ArgumentException

Es wird versucht, eine Stammstruktur zu löschen.

– oder –

subkey gibt keinen gültigen Registrierungsunterschlüssel an.

SecurityException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen, um den Schlüssel zu löschen.

ObjectDisposedException

Der zu bearbeitende RegistryKey ist geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).

UnauthorizedAccessException

Der Benutzer verfügt nicht über die notwendigen Registrierungsrechte.

Hinweise

Zum Löschen eines Unterschlüssels und dessen Struktur sind entsprechende Berechtigungen erforderlich.

Warnung

Bei Löschen eines bestimmten Schlüssels werden in der Struktur alle Einträge unter dem Schlüssel entfernt. Dies geschieht ohne Warnung. Verwenden Sie die DeleteSubKey-Methode, wenn ein Unterschlüssel nur dann gelöscht werden soll, wenn keine untergeordneten Unterschlüssel vorhanden sind.

Beispiel

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die RegistryKey-Klasse.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

RegistryKey-Klasse
RegistryKey-Member
Microsoft.Win32-Namespace
DeleteSubKey
CreateSubKey
DeleteValue
GetSubKeyNames
SubKeyCount

  • Last updated on