RegistryKey.DeleteSubKeyTree Méthode

Définition

Espace de noms:

Microsoft.Win32

Assembly:

Microsoft.Win32.Registry.dll

Supprime de manière récursive une sous-clé et toutes les sous-clés enfants, avec gestion des exceptions facultative.

Surcharges

DeleteSubKeyTree(String, Boolean)	Supprime de manière récursive la sous-clé spécifiée et toutes les sous-clés enfants, et spécifie si une exception est levée si la sous-clé est introuvable.
DeleteSubKeyTree(String)	Supprime récursivement une sous-clé et toutes les sous-clés enfants.

DeleteSubKeyTree(String, Boolean)

Supprime de manière récursive la sous-clé spécifiée et toutes les sous-clés enfants, et spécifie si une exception est levée si la sous-clé est introuvable.

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

public void DeleteSubKeyTree (string subkey, bool throwOnMissingSubKey);

member this.DeleteSubKeyTree : string * bool -> unit

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

Paramètres

subkey

String

Nom de la sous-clé à supprimer. Cette chaîne n'est pas sensible à la casse.

throwOnMissingSubKey

Boolean

Indique si une exception doit être déclenchée lorsque la sous-clé spécifiée est introuvable. Si cet argument a la valeur true et que la sous-clé spécifiée n'existe pas, une exception est levée. Si cet argument a la valeur false et que la sous-clé spécifiée n'existe pas, aucune action n'est entreprise.

Exceptions

ArgumentException

Une tentative a été faite pour supprimer la ruche racine de l'arborescence.

- ou -

subkey ne spécifie pas une sous-clé de Registre valide et throwOnMissingSubKey a la valeur true.

ArgumentNullException

subkey a la valeur null.

ObjectDisposedException

RegistryKey est fermé (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

L'utilisateur ne dispose pas des droits d'accès à la base de registres appropriés.

SecurityException

L'utilisateur n'a pas les autorisations requises pour supprimer la clé.

DeleteSubKeyTree(String)

Supprime récursivement une sous-clé et toutes les sous-clés enfants.

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

public void DeleteSubKeyTree (string subkey);

member this.DeleteSubKeyTree : string -> unit

Public Sub DeleteSubKeyTree (subkey As String)

Paramètres

subkey

String

Sous-clé à supprimer. Cette chaîne n'est pas sensible à la casse.

Exceptions

ArgumentNullException

subkey a la valeur null.

ArgumentException

Une tentative de suppression d'une ruche racine est effectuée.

- ou -

subkey ne spécifie pas une sous-clé de Registre valide.

IOException

Une erreur d’E/S s’est produite.

SecurityException

L'utilisateur n'a pas les autorisations requises pour supprimer la clé.

ObjectDisposedException

Le RegistryKey en cours de manipulation est fermé (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

L'utilisateur ne dispose pas des droits d'accès à la base de registres appropriés.

Exemples

Cet exemple de code fait partie d’un exemple plus grand fourni pour la RegistryKey classe .

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

Remarques

Vous devez disposer des autorisations appropriées pour supprimer la sous-clé et son arborescence.

Attention

La suppression d’une clé particulière supprime toutes les entrées sous la clé de l’arborescence. Aucun avertissement ne sera fourni. Si vous souhaitez supprimer une sous-clé uniquement lorsqu’elle n’a pas de sous-clés enfants, utilisez la DeleteSubKey méthode .

Voir aussi

• DeleteSubKey(String)
• CreateSubKey(String)
• DeleteValue(String)
• GetSubKeyNames()
• SubKeyCount