RegistryKey.DeleteSubKeyTree Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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)
- Source:
- RegistryKey.cs
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);[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)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.
- Attributi
Eccezioni
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.
subkey è null.
La chiave RegistryKey è chiusa, pertanto non è possibile accedere ad essa.
L'utente non dispone dei necessari diritti relativi al Registro di sistema.
L'utente non dispone delle autorizzazioni necessarie per eliminare la chiave.
Si applica a
DeleteSubKeyTree(String)
- Source:
- RegistryKey.cs
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 -> unitPublic Sub DeleteSubKeyTree (subkey As String)Parametri
- subkey
- String
Sottochiave da eliminare. Stringa senza distinzione tra maiuscole e minuscole.
Eccezioni
subkey è null.
Si è tentato di eliminare un hive radice.
-oppure-
subkey non specifica una sottochiave del Registro di sistema valida.
Si è verificato un errore di I/O.
L'utente non dispone delle autorizzazioni necessarie per eliminare la chiave.
La chiave RegistryKey da modificare è chiusa, pertanto non è possibile accedere ad essa.
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 .
