RegistryKey.DeleteSubKeyTree Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Win32

Zestaw:: Microsoft.Win32.Registry.dll

Zestaw:: mscorlib.dll

Pakiet:: Microsoft.Win32.Registry v5.0.0

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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)

Ź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, 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.

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

Dotyczy

.NET 9 i inne wersje

Produkt	Wersje
.NET	Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5

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

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.

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

Zobacz też

Dotyczy

.NET 9 i inne wersje

Produkt	Wersje
.NET	Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5

Udostępnij za pośrednictwem

RegistryKey.DeleteSubKeyTree Metoda

Definicja

Przeciążenia

DeleteSubKeyTree(String, Boolean)

Parametry

Wyjątki

Dotyczy

DeleteSubKeyTree(String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby