Udostępnij za pośrednictwem


RegistryKey.DeleteSubKeyTree Metoda

Definicja

Usuwa podklucz i wszystkie podrzędne podklucze cyklicznie z opcjonalną obsługą wyjątków.

Przeciążenia

DeleteSubKeyTree(String, Boolean)

Usuwa określony podklucz i wszystkie podrzędne podklucze rekursywnie i określa, czy wyjątek jest zgłaszany, jeśli podklucz nie zostanie znaleziony.

DeleteSubKeyTree(String)

Usuwa podklucz i wszystkie podrzędne podklucze cyklicznie.

DeleteSubKeyTree(String, Boolean)

Źródło:
RegistryKey.cs

Usuwa określony podklucz i wszystkie podrzędne podklucze rekursywnie i określa, czy wyjątek jest zgłaszany, jeśli podklucz nie zostanie znaleziony.

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

Nazwa podklucza do usunięcia. W tym ciągu nie jest rozróżniana wielkość liter.

throwOnMissingSubKey
Boolean

Wskazuje, czy należy podnieść wyjątek, jeśli nie można odnaleźć określonego podklucza. Jeśli ten argument jest true i określony podklucz nie istnieje, zostanie zgłoszony wyjątek. Jeśli ten argument jest false i określony podklucz nie istnieje, nie zostanie podjęta żadna akcja.

Atrybuty

Wyjątki

Podjęto próbę usunięcia gałęzi głównej drzewa.

-lub-

subkey nie określa prawidłowego podklucza rejestru i throwOnMissingSubKey ma wartość true.

subkey to null.

Jest RegistryKey zamknięty (nie można uzyskać dostępu do kluczy zamkniętych).

Użytkownik nie posiada niezbędnych praw wobec rejestru.

Użytkownik nie posiada uprawnień niezbędnych do usunięcia klucza.

Dotyczy

DeleteSubKeyTree(String)

Źródło:
RegistryKey.cs

Usuwa podklucz i wszystkie podrzędne podklucze cyklicznie.

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

Podklucz do usunięcia. W tym ciągu nie jest rozróżniana wielkość liter.

Wyjątki

subkey to null.

Podjęto próbę usunięcia gałęzi głównej.

-lub-

subkey nie określa prawidłowego podklucza rejestru.

Wystąpił błąd we/wy.

Użytkownik nie posiada uprawnień niezbędnych do usunięcia klucza.

Manipulowanie RegistryKey jest zamykane (nie można uzyskać dostępu do zamkniętych kluczy).

Użytkownik nie posiada niezbędnych praw wobec rejestru.

Przykłady

Ten przykład kodu jest częścią większego przykładu podanego RegistryKey dla klasy.

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

Uwagi

Aby usunąć podklucz i jego drzewo, musisz mieć odpowiednie uprawnienia.

Przestroga

Usunięcie określonego klucza spowoduje usunięcie wszystkich wpisów poniżej klucza w drzewie. Nie zostanie podane żadne ostrzeżenie. Jeśli chcesz usunąć podklucz tylko wtedy, gdy nie ma podrzędnych podkluczów, użyj DeleteSubKey metody .

Zobacz też

Dotyczy