Język

RegistryKey.DeleteSubKeyTree Metoda

Definicja

Przestrzeń nazw:
Microsoft.Win32
Zestaw:
Microsoft.Win32.Registry.dll
Zestaw:
mscorlib.dll
Pakiet:
Microsoft.Win32.Registry v5.0.0

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

Przeciążenia

Nazwa Opis
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)

Źródło:
RegistryKey.cs

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);
[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. 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 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
ComVisibleAttribute

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

Parametr subkey ma wartość null.

ObjectDisposedException

Element 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.

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

Wyjątki

ArgumentNullException

Parametr subkey ma wartość 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 zamykane (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.

Caution

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