RegistryKey.DeleteSubKeyTree Metodo

Definizione

Spazio dei nomi:

Microsoft.Win32

Assembly:

Microsoft.Win32.Registry.dll

Elimina in modo ricorsivo una sottochiave e qualsiasi sottochiave figlio, con gestione delle eccezioni facoltativa.

Overload

DeleteSubKeyTree(String, Boolean)	Elimina in modo ricorsivo la sottochiave specificata e qualsiasi sottochiave figlio e specifica se generare un'eccezione se la sottochiave non viene trovata.
DeleteSubKeyTree(String)	Elimina in modo ricorsivo una sottochiave e le eventuali sottochiavi figlio.

DeleteSubKeyTree(String, Boolean)

Elimina in modo ricorsivo la sottochiave specificata e qualsiasi sottochiave figlio e specifica se generare un'eccezione se la sottochiave non viene trovata.

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)

Parametri

subkey

String

Nome della sottochiave da eliminare. Stringa senza distinzione tra maiuscole e minuscole.

throwOnMissingSubKey

Boolean

Indica se deve essere generata un'eccezione qualora non venisse trovata la sottochiave specificata. Se questo argomento è true e la sottochiave specificata non esiste, viene generata un'eccezione. Se l'argomento è false e la sottochiave specificata non esiste, non viene eseguita alcuna azione.

Eccezioni

ArgumentException

Si è tentato di eliminare l'hive radice della struttura a albero.

-oppure-

subkey non specifica una sottochiave del Registro di sistema valida e throwOnMissingSubKey è true.

ArgumentNullException

subkey è null.

ObjectDisposedException

La chiave RegistryKey è chiusa, pertanto non è possibile accedere ad essa.

UnauthorizedAccessException

L'utente non dispone dei necessari diritti relativi al Registro di sistema.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eliminare la chiave.

DeleteSubKeyTree(String)

Elimina in modo ricorsivo una sottochiave e le eventuali sottochiavi figlio.

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

public void DeleteSubKeyTree (string subkey);

member this.DeleteSubKeyTree : string -> unit

Public Sub DeleteSubKeyTree (subkey As String)

Parametri

subkey

String

Sottochiave da eliminare. Stringa senza distinzione tra maiuscole e minuscole.

Eccezioni

ArgumentNullException

subkey è null.

ArgumentException

Si è tentato di eliminare un hive radice.

-oppure-

subkey non specifica una sottochiave del Registro di sistema valida.

IOException

Si è verificato un errore di I/O.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eliminare la chiave.

ObjectDisposedException

La chiave RegistryKey da modificare è chiusa, pertanto non è possibile accedere ad essa.

UnauthorizedAccessException

L'utente non dispone dei necessari diritti relativi al Registro di sistema.

Esempio

Questo esempio di codice fa parte di un esempio più ampio fornito per 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

Commenti

È necessario disporre delle autorizzazioni appropriate per eliminare la sottochiave e la relativa struttura ad albero.

Attenzione

L'eliminazione di una chiave specifica rimuoverà tutte le voci sotto la chiave nell'albero. Non verrà visualizzato alcun avviso. Se si vuole eliminare una sottochiave solo quando non dispone di sottochiavi figlio, usare il DeleteSubKey metodo .

Vedi anche

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