RegistryKey.DeleteSubKeyTree Metod

Definition

Namnområde:
Microsoft.Win32
Sammansättning:
mscorlib.dll

Tar bort en undernyckel och eventuella underordnade undernycklar rekursivt, med valfri undantagshantering.

Överlagringar

Name Description
DeleteSubKeyTree(String, Boolean)

Tar bort den angivna undernyckeln och eventuella underordnade undernycklar rekursivt och anger om ett undantag utlöses om undernyckeln inte hittas.
DeleteSubKeyTree(String)

Tar bort en undernyckel och eventuella underordnade undernycklar rekursivt.

DeleteSubKeyTree(String, Boolean)

Tar bort den angivna undernyckeln och eventuella underordnade undernycklar rekursivt och anger om ett undantag utlöses om undernyckeln inte hittas.

public:
 void DeleteSubKeyTree(System::String ^ subkey, bool throwOnMissingSubKey);
[System.Runtime.InteropServices.ComVisible(false)]
public void DeleteSubKeyTree(string subkey, bool throwOnMissingSubKey);
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DeleteSubKeyTree : string * bool -> unit
Public Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)

Parametrar

subkey
String

Namnet på undernyckeln som ska tas bort. Den här strängen är inte skiftlägeskänslig.

throwOnMissingSubKey
Boolean

Anger om ett undantag ska aktiveras om den angivna undernyckeln inte kan hittas. Om det här argumentet är true och den angivna undernyckeln inte finns utlöses ett undantag. Om det här argumentet är false och den angivna undernyckeln inte finns, vidtas ingen åtgärd.

Attribut
ComVisibleAttribute

Undantag

ArgumentException

Ett försök gjordes att ta bort rotdatafilen i trädet.

-eller-

subkey anger inte en giltig registerundernyckel och throwOnMissingSubKey är true.

ArgumentNullException

subkey är null.

ObjectDisposedException

RegistryKey Är stängd (stängda nycklar kan inte nås).

UnauthorizedAccessException

Användaren har inte de nödvändiga registerrättigheterna.

SecurityException

Användaren har inte de behörigheter som krävs för att ta bort nyckeln.

Gäller för

DeleteSubKeyTree(String)

Tar bort en undernyckel och eventuella underordnade undernycklar rekursivt.

public:
 void DeleteSubKeyTree(System::String ^ subkey);
public void DeleteSubKeyTree(string subkey);
member this.DeleteSubKeyTree : string -> unit
Public Sub DeleteSubKeyTree (subkey As String)

Parametrar

subkey
String

Undernyckeln som ska tas bort. Den här strängen är inte skiftlägeskänslig.

Undantag

ArgumentNullException

subkey är null.

ArgumentException

Ett försök görs att ta bort en rotdatafil.

-eller-

subkey anger inte en giltig registerundernyckel.

IOException

Ett I/O-fel har inträffat.

SecurityException

Användaren har inte de behörigheter som krävs för att ta bort nyckeln.

ObjectDisposedException

Den RegistryKey som manipuleras stängs (stängda nycklar kan inte nås).

UnauthorizedAccessException

Användaren har inte de nödvändiga registerrättigheterna.

Exempel

Det här kodexemplet är en del av ett större exempel för RegistryKey klassen.

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

Kommentarer

Du måste ha rätt behörighet för att ta bort undernyckeln och dess träd.

Caution

Om du tar bort en viss nyckel tas alla poster under nyckeln i trädet bort. Ingen varning kommer att ges. Om du bara vill ta bort en undernyckel när den inte har några underordnade undernycklar använder du DeleteSubKey metoden .

Se även

Gäller för