RegistryKey.DeleteSubKeyTree Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verwijdert u een subsleutel en eventuele onderliggende subsleutels recursief, met optionele uitzonderingsafhandeling.
Overloads
| Name | Description |
|---|---|
| DeleteSubKeyTree(String, Boolean) |
Hiermee verwijdert u de opgegeven subsleutel en alle onderliggende subsleutels recursief en geeft u op of er een uitzondering wordt gegenereerd als de subsleutel niet wordt gevonden. |
| DeleteSubKeyTree(String) |
Hiermee verwijdert u een subsleutel en eventuele onderliggende subsleutels recursief. |
DeleteSubKeyTree(String, Boolean)
Hiermee verwijdert u de opgegeven subsleutel en alle onderliggende subsleutels recursief en geeft u op of er een uitzondering wordt gegenereerd als de subsleutel niet wordt gevonden.
public:
void DeleteSubKeyTree(System::String ^ subkey, bool throwOnMissingSubKey);[System.Runtime.InteropServices.ComVisible(false)]
public void DeleteSubKeyTree(string subkey, bool throwOnMissingSubKey);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DeleteSubKeyTree : string * bool -> unitPublic Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)Parameters
- subkey
- String
De naam van de subsleutel die u wilt verwijderen. Deze tekenreeks is niet hoofdlettergevoelig.
- throwOnMissingSubKey
- Boolean
Geeft aan of er een uitzondering moet worden gegenereerd als de opgegeven subsleutel niet kan worden gevonden. Als dit argument is true en de opgegeven subsleutel niet bestaat, wordt er een uitzondering gegenereerd. Als dit argument is false en de opgegeven subsleutel niet bestaat, wordt er geen actie ondernomen.
- Kenmerken
Uitzonderingen
Er is een poging gedaan om de hoofd hive van de boom te verwijderen.
– of –
subkey geeft geen geldige registersubsleutel op en throwOnMissingSubKey is true.
subkey is null.
De RegistryKey sleutel is gesloten (gesloten sleutels kunnen niet worden geopend).
De gebruiker beschikt niet over de benodigde registerrechten.
De gebruiker beschikt niet over de vereiste machtigingen om de sleutel te verwijderen.
Van toepassing op
DeleteSubKeyTree(String)
Hiermee verwijdert u een subsleutel en eventuele onderliggende subsleutels recursief.
public:
void DeleteSubKeyTree(System::String ^ subkey);public void DeleteSubKeyTree(string subkey);member this.DeleteSubKeyTree : string -> unitPublic Sub DeleteSubKeyTree (subkey As String)Parameters
- subkey
- String
De subsleutel die u wilt verwijderen. Deze tekenreeks is niet hoofdlettergevoelig.
Uitzonderingen
subkey is null.
Het verwijderen van een hoofd hive wordt geprobeerd.
– of –
subkey geeft geen geldige registersubsleutel op.
Er is een I/O-fout opgetreden.
De gebruiker beschikt niet over de vereiste machtigingen om de sleutel te verwijderen.
Het RegistryKey bewerken is gesloten (gesloten sleutels kunnen niet worden geopend).
De gebruiker beschikt niet over de benodigde registerrechten.
Voorbeelden
Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de RegistryKey klasse.
// 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
Opmerkingen
U moet over de juiste machtigingen beschikken om de subsleutel en de structuur ervan te verwijderen.
Caution
Als u een bepaalde sleutel verwijdert, worden alle vermeldingen onder de sleutel in de structuur verwijderd. Er wordt geen waarschuwing gegeven. Als u een subsleutel alleen wilt verwijderen wanneer deze geen onderliggende subsleutels heeft, gebruikt u de DeleteSubKey methode.