RegistryKey.DeleteSubKeyTree Yöntem

Tanım

Ad Alanı:

Microsoft.Win32

Bütünleştirilmiş Kod:

Microsoft.Win32.Registry.dll

İsteğe bağlı özel durum işleme ile bir alt anahtarı ve alt alt anahtarları yinelemeli olarak siler.

Aşırı Yüklemeler

DeleteSubKeyTree(String, Boolean)	Belirtilen alt anahtarı ve alt alt anahtarları yinelemeli olarak siler ve alt anahtar bulunamazsa özel durumun tetiklenip tetiklenmeyeceğini belirtir.
DeleteSubKeyTree(String)	Bir alt anahtarı ve alt alt anahtarları yinelemeli olarak siler.

DeleteSubKeyTree(String, Boolean)

Belirtilen alt anahtarı ve alt alt anahtarları yinelemeli olarak siler ve alt anahtar bulunamazsa özel durumun tetiklenip tetiklenmeyeceğini belirtir.

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)

Parametreler

subkey

String

Silinecek alt anahtarın adı. Bu dize, büyük küçük harf duyarlı değildir.

throwOnMissingSubKey

Boolean

Belirtilen alt anahtar bulunamazsa özel durumun tetiklenip tetiklenmeyeceğini gösterir. Bu bağımsız değişken ise true ve belirtilen alt anahtar yoksa, bir özel durum oluşturulur. Bu bağımsız değişken ise false ve belirtilen alt anahtar yoksa hiçbir eylem yapılmaz.

Özel durumlar

ArgumentException

Ağacın kök kovanını silme girişiminde bulunuldu.

-veya-

subkey geçerli bir kayıt defteri alt anahtarı belirtmez ve throwOnMissingSubKey şeklindedir true.

ArgumentNullException

subkey, null değeridir.

ObjectDisposedException

RegistryKey kapalıdır (kapalı anahtarlara erişilemez).

UnauthorizedAccessException

Kullanıcının gerekli kayıt defteri hakları yok.

SecurityException

Kullanıcı anahtarı silmek için gerekli izinlere sahip değildir.

DeleteSubKeyTree(String)

Bir alt anahtarı ve alt alt anahtarları yinelemeli olarak siler.

public:
 void DeleteSubKeyTree(System::String ^ subkey);

public void DeleteSubKeyTree (string subkey);

member this.DeleteSubKeyTree : string -> unit

Public Sub DeleteSubKeyTree (subkey As String)

Parametreler

subkey

String

Silinecek alt anahtar. Bu dize, büyük küçük harf duyarlı değildir.

Özel durumlar

ArgumentNullException

subkey, null değeridir.

ArgumentException

Kök kovan silinmeye çalışılır.

-veya-

subkey geçerli bir kayıt defteri alt anahtarı belirtmez.

IOException

G/Ç hatası oluştu.

SecurityException

Kullanıcı anahtarı silmek için gerekli izinlere sahip değildir.

ObjectDisposedException

İşlenen RegistryKey kapatılır (kapalı anahtarlara erişilemez).

UnauthorizedAccessException

Kullanıcının gerekli kayıt defteri hakları yok.

Örnekler

Bu kod örneği, sınıfı için RegistryKey sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Alt anahtarı ve ağacını silmek için uygun izinlere sahip olmanız gerekir.

Dikkat

Belirli bir anahtarın silinmesi, ağaçtaki anahtarın altındaki tüm girişleri kaldırır. Hiçbir uyarı sağlanamaz. Alt anahtarı yalnızca alt anahtar olmadığında silmek istiyorsanız yöntemini kullanın DeleteSubKey .

Ayrıca bkz.

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