RegistryKey.DeleteSubKeyTree Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht einen Unterschlüssel und alle untergeordneten Unterschlüssel rekursiv, mit optionaler Ausnahmebehandlung.
Überlädt
| DeleteSubKeyTree(String, Boolean) |
Löscht den angegebenen Unterschlüssel und alle untergeordneten Unterschlüssel rekursiv und gibt an, ob eine Ausnahme ausgelöst wird, wenn der Unterschlüssel nicht gefunden wird. |
| DeleteSubKeyTree(String) |
Löscht einen Unterschlüssel und alle untergeordneten Unterschlüssel rekursiv. |
DeleteSubKeyTree(String, Boolean)
- Quelle:
- RegistryKey.cs
Löscht den angegebenen Unterschlüssel und alle untergeordneten Unterschlüssel rekursiv und gibt an, ob eine Ausnahme ausgelöst wird, wenn der Unterschlüssel nicht gefunden wird.
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 -> unitPublic Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)Parameter
- subkey
- String
Der Name des zu löschenden Unterschlüssels. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet.
- throwOnMissingSubKey
- Boolean
Gibt an, ob eine Ausnahme ausgelöst werden soll, wenn der angegebene Unterschlüssel nicht gefunden werden kann. Wenn dieses Argument true ist und der angegebene Unterschlüssel nicht vorhanden ist, wird eine Ausnahme ausgelöst. Wenn dieses Argument false ist und der angegebene Unterschlüssel nicht vorhanden ist, wird keine Aktion ausgeführt.
- Attribute
Ausnahmen
Es wurde versucht, die Stammstruktur der Struktur zu löschen.
-oder-
subkey gibt keinen gültigen Registrierungsunterschlüssel an, und throwOnMissingSubKey ist true.
subkey ist null.
Die RegistryKey ist geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).
Der Benutzer verfügt nicht über die erforderlichen Registrierungsrechte.
Der Benutzer verfügt nicht über die zum Löschen des Schlüssels erforderlichen Berechtigungen.
Gilt für:
DeleteSubKeyTree(String)
- Quelle:
- RegistryKey.cs
Löscht einen Unterschlüssel und alle untergeordneten Unterschlüssel rekursiv.
public:
void DeleteSubKeyTree(System::String ^ subkey);public void DeleteSubKeyTree (string subkey);member this.DeleteSubKeyTree : string -> unitPublic Sub DeleteSubKeyTree (subkey As String)Parameter
- subkey
- String
Der zu löschende Unterschlüssel. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet.
Ausnahmen
subkey ist null.
Das Löschen einer Stammstruktur wird versucht.
-oder-
subkey gibt keinen gültigen Registrierungsunterschlüssel an.
Ein E/A-Fehler ist aufgetreten.
Der Benutzer verfügt nicht über die zum Löschen des Schlüssels erforderlichen Berechtigungen.
Die RegistryKey, die bearbeitet werden, wird geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).
Der Benutzer verfügt nicht über die erforderlichen Registrierungsrechte.
Beispiele
Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die RegistryKey-Klasse bereitgestellt wird.
// 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
Hinweise
Sie müssen über entsprechende Berechtigungen zum Löschen des Unterschlüssels und seiner Struktur verfügen.
Vorsicht
Beim Löschen eines bestimmten Schlüssels werden alle Einträge unterhalb des Schlüssels in der Struktur entfernt. Es wird keine Warnung angezeigt. Wenn Sie einen Unterschlüssel nur löschen möchten, wenn er über keine untergeordneten Unterschlüssel verfügt, verwenden Sie die DeleteSubKey-Methode.
