RegistryKey.DeleteSubKey Methode

Definitie

Naamruimte:: Microsoft.Win32

Assembly:: mscorlib.dll

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 de opgegeven subsleutel.

Overloads

Name	Description
DeleteSubKey(String)	Hiermee verwijdert u de opgegeven subsleutel.
DeleteSubKey(String, Boolean)	Hiermee verwijdert u de opgegeven subsleutel en geeft u op of er een uitzondering wordt gegenereerd als de subsleutel niet wordt gevonden.

DeleteSubKey(String)

Hiermee verwijdert u de opgegeven subsleutel.

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

public void DeleteSubKey(string subkey);

member this.DeleteSubKey : string -> unit

Public Sub DeleteSubKey (subkey As String)

Parameters

subkey: String

De naam van de subsleutel die u wilt verwijderen. Deze tekenreeks is niet hoofdlettergevoelig.

Uitzonderingen

InvalidOperationException

De subkey subsleutel heeft onderliggende subsleutels

ArgumentException

De subkey parameter geeft geen geldige registersleutel op

ArgumentNullException

subkey Is null

SecurityException

De gebruiker beschikt niet over de vereiste machtigingen om de sleutel te verwijderen.

ObjectDisposedException

Het RegistryKey bewerken is gesloten (gesloten sleutels kunnen niet worden geopend).

UnauthorizedAccessException

De gebruiker beschikt niet over de benodigde registerrechten.

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze kunt gebruiken DeleteSubKey.

using namespace System;
using namespace Microsoft::Win32;

public ref class RegKeyDel
{
public:
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey^ test9999 =
            Registry::CurrentUser->CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        RegistryKey^ testName = test9999->CreateSubKey("TestName");
        RegistryKey^ testSettings = test9999->CreateSubKey("TestSettings");

        // Create data for the TestSettings subkey.
        testSettings->SetValue("Language", "French");
        testSettings->SetValue("Level", "Intermediate");
        testSettings->SetValue("ID", 123);

        // delete the subkey "TestName"
        test9999->DeleteSubKey("TestName");
        // delete everything under and including "Test9999"
        Registry::CurrentUser->DeleteSubKeyTree("Test9999");
    }
};

int main()
{
    RegKeyDel::Main();
}

using System;
using Microsoft.Win32;

class RegKeyDel
{
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey test9999 =
            Registry.CurrentUser.CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        RegistryKey testName = test9999.CreateSubKey("TestName");
        RegistryKey testSettings = test9999.CreateSubKey("TestSettings");

        // Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French");
        testSettings.SetValue("Level", "Intermediate");
        testSettings.SetValue("ID", 123);

        // delete the subkey "TestName"
        test9999.DeleteSubKey("TestName");
        // delete everything under and including "Test9999"
        Registry.CurrentUser.DeleteSubKeyTree("Test9999");
    }
}

Imports Microsoft.Win32

Public Class RegKeyDel
    Public Shared Sub Main()
        ' Create a subkey named Test9999 under HKEY_CURRENT_USER.
        Dim test9999 As RegistryKey = _
            Registry.CurrentUser.CreateSubKey("Test9999")
        ' Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        ' keys are disposed when execution exits the using statement.
        Dim testName As RegistryKey = test9999.CreateSubKey("TestName")
        Dim testSettings As RegistryKey = test9999.CreateSubKey("TestSettings")

        ' Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French")
        testSettings.SetValue("Level", "Intermediate")
        testSettings.SetValue("ID", 123)

        ' delete the subkey "TestName"
        test9999.DeleteSubKey("TestName")
        ' delete everything under and including "Test9999"
        Registry.CurrentUser.DeleteSubKeyTree("Test9999")
    End Sub
End Class

Opmerkingen

Als u onderliggende subsleutels wilt verwijderen, gebruikt u DeleteSubKeyTree.

Wees voorzichtig bij het verwijderen van registersleutels.

Zie ook

Van toepassing op

DeleteSubKey(String, Boolean)

Hiermee verwijdert u de opgegeven subsleutel en geeft u op of er een uitzondering wordt gegenereerd als de subsleutel niet wordt gevonden.

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

public void DeleteSubKey(string subkey, bool throwOnMissingSubKey);

member this.DeleteSubKey : string * bool -> unit

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