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 cyklicznie 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 cyklicznie 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. Ten ciąg nie uwzględnia wielkości liter.

throwOnMissingSubKey

Boolean

Wskazuje, czy należy zgłaszać wyjątek, jeśli nie można odnaleźć określonego podklucza. Jeśli ten argument jest true, a 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, a throwOnMissingSubKey jest true.

ArgumentNullException

subkey jest null.

ObjectDisposedException

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

UnauthorizedAccessException

Użytkownik nie ma niezbędnych praw rejestru.

SecurityException

Użytkownik nie ma uprawnień wymaganych 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. Ten ciąg nie uwzględnia wielkości liter.

Wyjątki

ArgumentNullException

subkey jest 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 ma uprawnień wymaganych do usunięcia klucza.

ObjectDisposedException

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

UnauthorizedAccessException

Użytkownik nie ma niezbędnych praw rejestru.

Przykłady

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

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

Musisz mieć odpowiednie uprawnienia, aby usunąć podklucz i jego drzewo.

Ostrożność

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 podklucza podrzędnego, użyj metody DeleteSubKey.

Zobacz też

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