RegistryKey.DeleteSubKeyTree Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Elimina una subclave y las subclaves secundarias de forma recursiva, con control de excepciones opcional.
Sobrecargas
| 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)
- Source:
- RegistryKey.cs
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);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)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
Excepciones
Se intentó eliminar el subárbol raíz del árbol.
-o-
subkey no especifica una subclave del Registro válida y throwOnMissingSubKey es true.
subkey es null.
El RegistryKey está cerrado (no se puede acceder a las claves cerradas).
El usuario no tiene los derechos del Registro necesarios.
El usuario no tiene los permisos necesarios para eliminar la clave.
Se aplica a
DeleteSubKeyTree(String)
- Source:
- RegistryKey.cs
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 -> unitPublic 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
subkey es null.
Se intenta eliminar un subárbol raíz.
-o-
subkey no especifica una subclave del Registro válida.
Se ha producido un error de E/S.
El usuario no tiene los permisos necesarios para eliminar la clave.
El RegistryKey manipulado está cerrado (no se puede acceder a las claves cerradas).
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 clase RegistryKey.
// 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.
Cautela
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 método DeleteSubKey.
