Compartir a través de


RegistryKey.DeleteSubKey Método

Definición

Elimina la subclave especificada.

Sobrecargas

DeleteSubKey(String)

Elimina la subclave especificada.

DeleteSubKey(String, Boolean)

Elimina la subclave especificada e indica si se inicia una excepción cuando no se encuentra la subclave.

DeleteSubKey(String)

Source:
RegistryKey.cs

Elimina la subclave especificada.

public:
 void DeleteSubKey(System::String ^ subkey);
public void DeleteSubKey (string subkey);
member this.DeleteSubKey : string -> unit
Public Sub DeleteSubKey (subkey As String)

Parámetros

subkey
String

Nombre de la subclave que se va a eliminar. Esta cadena no distingue entre mayúsculas y minúsculas.

Excepciones

subkey tiene subclaves secundarias.

El subkey parámetro no especifica una clave del Registro válida.

subkey es null

El usuario no tiene los permisos necesarios para eliminar la clave.

La RegistryKey que se ha manipulado está cerrada (no se puede tener acceso a las claves cerradas).

El usuario no tiene los derechos necesarios en el Registro.

Ejemplos

En el ejemplo siguiente se muestra cómo usar 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

Comentarios

Para eliminar subclaves secundarias, use DeleteSubKeyTree.

Tenga cuidado al eliminar las claves del Registro.

Consulte también

Se aplica a

DeleteSubKey(String, Boolean)

Source:
RegistryKey.cs

Elimina la subclave especificada e indica si se inicia una excepción cuando no se encuentra la subclave.

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)

Parámetros

subkey
String

Nombre de la subclave que se va a eliminar. Esta cadena no distingue entre mayúsculas y minúsculas.

throwOnMissingSubKey
Boolean

Indica si debería producirse una excepción si no se puede encontrar la subclave especificada. Si este argumento es true y la subclave especificada no existe, se genera una excepción. Si este argumento es false y la subclave especificada no existe, no se lleva a cabo ninguna acción.

Excepciones

subkey tiene subclaves secundarias.

subkey no especifica una clave del Registro válida y throwOnMissingSubKey es true.

subkey es null.

El usuario no tiene los permisos necesarios para eliminar la clave.

La RegistryKey que se ha manipulado está cerrada (no se puede tener acceso a las claves cerradas).

El usuario no tiene los derechos necesarios en el Registro.

Comentarios

Para eliminar subclaves secundarias, use DeleteSubKeyTree.

Tenga cuidado al eliminar las claves del Registro.

Consulte también

Se aplica a