RegistryKey.DeleteSubKeyTree Metodo

Definizione

Spazio dei nomi:
Microsoft.Win32
Assembly:
Microsoft.Win32.Registry.dll
Assembly:
mscorlib.dll
Pacchetto:
Microsoft.Win32.Registry v5.0.0

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

Overload

Nome Descrizione
DeleteSubKeyTree(String, Boolean)

Elimina la sottochiave specificata e tutte le sottochiavi figlio in modo ricorsivo e specifica se viene generata un'eccezione se la sottochiave non viene trovata.
DeleteSubKeyTree(String)

Elimina una sottochiave e qualsiasi sottochiave figlio in modo ricorsivo.

DeleteSubKeyTree(String, Boolean)

Origine:
RegistryKey.cs

Elimina la sottochiave specificata e tutte le sottochiavi figlio in modo ricorsivo e specifica se viene generata un'eccezione se la sottochiave non viene trovata.

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

Parametri

subkey
String

Nome della sottochiave da eliminare. Questa stringa non fa distinzione tra maiuscole e minuscole.

throwOnMissingSubKey
Boolean

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

Attributi
ComVisibleAttribute

Eccezioni

ArgumentException

È stato effettuato un tentativo di eliminare l'hive radice dell'albero.

oppure

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

ArgumentNullException

subkey è null.

ObjectDisposedException

è RegistryKey chiuso (non è possibile accedere alle chiavi chiuse).

UnauthorizedAccessException

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

SecurityException

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

Si applica a

DeleteSubKeyTree(String)

Origine:
RegistryKey.cs

Elimina una sottochiave e qualsiasi sottochiave figlio in modo ricorsivo.

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. Questa stringa non fa distinzione tra maiuscole e minuscole.

Eccezioni

ArgumentNullException

subkey è null.

ArgumentException

Viene tentata l'eliminazione di un hive radice.

oppure

subkey non specifica una sottochiave valida del Registro di sistema.

IOException

Si è verificato un errore di I/O.

SecurityException

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

ObjectDisposedException

L'oggetto RegistryKey modificato è chiuso (non è possibile accedere alle chiavi chiuse).

UnauthorizedAccessException

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

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 il relativo albero.

Attenzione

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

Vedi anche

Si applica a