RegistryKey.DeleteSubKeyTree Méthode

Définition

Espace de noms:
Microsoft.Win32
Assembly:
mscorlib.dll

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

Surcharges

Nom Description
DeleteSubKeyTree(String, Boolean)

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

Supprime une sous-clé et toutes les sous-clés enfants de manière récursive.

DeleteSubKeyTree(String, Boolean)

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

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)

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 levée si la sous-clé spécifiée est introuvable. Si cet argument est true et que la sous-clé spécifiée n’existe pas, une exception est levée. Si cet argument est false et que la sous-clé spécifiée n’existe pas, aucune action n’est effectuée.

Attributs
ComVisibleAttribute

Exceptions

ArgumentException

Une tentative a été effectuée pour supprimer la ruche racine de l’arborescence.

-ou-

subkey ne spécifie pas de sous-clé de Registre valide et throwOnMissingSubKey est true.

ArgumentNullException

subkey a la valeur null.

ObjectDisposedException

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

UnauthorizedAccessException

L’utilisateur n’a pas les droits de Registre nécessaires.

SecurityException

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

S’applique à

DeleteSubKeyTree(String)

Supprime une sous-clé et toutes les sous-clés enfants de manière récursive.

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

La suppression d’une ruche racine est tentée.

-ou-

subkey ne spécifie pas de 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

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

UnauthorizedAccessException

L’utilisateur n’a pas les droits de Registre nécessaires.

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.

Avertissement

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

Voir aussi

S’applique à