Sdílet prostřednictvím


RegistryKey.DeleteSubKeyTree Metoda

Definice

Odstraní podklíč a všechny podřízené podklíče rekurzivně s volitelným zpracováním výjimek.

Přetížení

DeleteSubKeyTree(String, Boolean)

Odstraní zadaný podklíč a všechny podřízené podklíče rekurzivně a určuje, zda je vyvolána výjimka, pokud podklíč nebyl nalezen.

DeleteSubKeyTree(String)

Odstraní podklíč a všechny podřízené podklíče rekurzivně.

DeleteSubKeyTree(String, Boolean)

Zdroj:
RegistryKey.cs

Odstraní zadaný podklíč a všechny podřízené podklíče rekurzivně a určuje, zda je vyvolána výjimka, pokud podklíč nebyl nalezen.

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)

Parametry

subkey
String

Název podklíče, který se má odstranit. Tento řetězec neodlišuje velká a malá písmena.

throwOnMissingSubKey
Boolean

Určuje, zda má být vyvolána výjimka, pokud zadaný podklíč nebyl nalezen. Pokud je true tento argument a zadaný podklíč neexistuje, je vyvolána výjimka. Pokud je false tento argument a zadaný podklíč neexistuje, neprovede se žádná akce.

Atributy

Výjimky

Došlo k pokusu o odstranění kořenového podregistru stromu.

-nebo-

subkey nezadá platný podklíč registru a throwOnMissingSubKey je true.

subkey je null.

Je RegistryKey zavřený (zavřené klíče nelze získat přístup).

Uživatel nemá nezbytná oprávnění pro registr.

Uživatel nemá oprávnění nutná k odstranění klíče.

Platí pro

DeleteSubKeyTree(String)

Zdroj:
RegistryKey.cs

Odstraní podklíč a všechny podřízené podklíče rekurzivně.

public:
 void DeleteSubKeyTree(System::String ^ subkey);
public void DeleteSubKeyTree (string subkey);
member this.DeleteSubKeyTree : string -> unit
Public Sub DeleteSubKeyTree (subkey As String)

Parametry

subkey
String

Podklíč, který chcete odstranit. Tento řetězec neodlišuje velká a malá písmena.

Výjimky

subkey je null.

Došlo k pokusu o odstranění kořenového podregistru.

-nebo-

subkey nezadá platný podklíč registru.

Došlo k vstupně-výstupní chybě.

Uživatel nemá oprávnění nutná k odstranění klíče.

Manipulovaný RegistryKey objekt je zavřený (nelze získat přístup k uzavřeným klíčům).

Uživatel nemá nezbytná oprávnění pro registr.

Příklady

Tento příklad kódu je součástí většího příkladu RegistryKey pro třídu .

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

Poznámky

K odstranění podklíče a jeho stromu musíte mít příslušná oprávnění.

Upozornění

Odstraněním konkrétního klíče odeberete všechny položky pod klíčem ve stromu. Nezobrazí se žádné upozornění. Pokud chcete odstranit podklíč jenom v případě, že nemá žádné podřízené podklíče, použijte metodu DeleteSubKey .

Viz také

Platí pro