RegistryKey.DeleteSubKeyTree Metoda

Definicja

Przestrzeń nazw:

Microsoft.Win32

Zestaw:

Microsoft.Win32.Registry.dll

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)

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);

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.

Wyjątki

ArgumentException

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.

ArgumentNullException

subkey to null.

ObjectDisposedException

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

UnauthorizedAccessException

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

SecurityException

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

DeleteSubKeyTree(String)

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

ArgumentNullException

subkey to null.

ArgumentException

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

-lub-

subkey nie określa prawidłowego podklucza rejestru.

IOException

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

SecurityException

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

ObjectDisposedException

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

UnauthorizedAccessException

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ż

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