RegistryKey.DeleteSubKeyTree Método

Definición

Espacio de nombres:
Microsoft.Win32
Ensamblado:
mscorlib.dll

Elimina una subclave y las subclaves secundarias de forma recursiva, con control de excepciones opcional.

Sobrecargas

Nombre Description
DeleteSubKeyTree(String, Boolean)

Elimina la subclave especificada y las subclaves secundarias de forma recursiva y especifica si se produce una excepción si no se encuentra la subclave.
DeleteSubKeyTree(String)

Elimina una subclave y las subclaves secundarias de forma recursiva.

DeleteSubKeyTree(String, Boolean)

Elimina la subclave especificada y las subclaves secundarias de forma recursiva y especifica si se produce una excepción si no se encuentra la subclave.

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 -> unit
Public Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)

Parámetros

subkey
String

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

throwOnMissingSubKey
Boolean

Indica si no se puede encontrar una excepción si no se encuentra 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 realiza ninguna acción.

Atributos
ComVisibleAttribute

Excepciones

ArgumentException

Se intentó eliminar el subárbol raíz del árbol.

O bien

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

ArgumentNullException

subkey es null.

ObjectDisposedException

RegistryKey está cerrado (no se puede acceder a las claves cerradas).

UnauthorizedAccessException

El usuario no tiene los derechos del Registro necesarios.

SecurityException

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

Se aplica a

DeleteSubKeyTree(String)

Elimina una subclave y las subclaves secundarias de forma recursiva.

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

Parámetros

subkey
String

Subclave que se va a eliminar. Esta cadena no distingue mayúsculas de minúsculas.

Excepciones

ArgumentNullException

subkey es null.

ArgumentException

Se intenta eliminar un subárbol raíz.

O bien

subkey no especifica una subclave del Registro válida.

IOException

Se ha producido un error de E/S.

SecurityException

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

ObjectDisposedException

El RegistryKey objeto que se está manipulando está cerrado (no se puede acceder a las claves cerradas).

UnauthorizedAccessException

El usuario no tiene los derechos del Registro necesarios.

Ejemplos

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la RegistryKey clase .

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

Comentarios

Debe tener los permisos adecuados para eliminar la subclave y su árbol.

Caution

Al eliminar una clave determinada, se quitarán todas las entradas debajo de la clave del árbol. No se proporcionará ninguna advertencia. Si desea eliminar una subclave solo cuando no tenga subclaves secundarias, use el DeleteSubKey método .

Consulte también

Se aplica a