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 durum oluşturup oluşturmayacağını 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 durum oluşturup oluşturmayacağını 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 harfe duyarlı değildir.

throwOnMissingSubKey

Boolean

Belirtilen alt anahtar bulunamazsa özel durum oluşturulup oluşturulmayacağını gösterir. Bu bağımsız değişken true ve belirtilen alt anahtar yoksa, bir özel durum oluşturulur. Bu bağımsız değişken false ve belirtilen alt anahtar yoksa hiçbir işlem 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 throwOnMissingSubKeytrue.

ArgumentNullException

subkey null.

ObjectDisposedException

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

UnauthorizedAccessException

Kullanıcı gerekli kayıt defteri haklarına sahip değil.

SecurityException

Kullanıcının anahtarı silmek için gereken izinleri yok.

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 harfe duyarlı değildir.

Özel durumlar

ArgumentNullException

subkey null.

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ının anahtarı silmek için gereken izinleri yok.

ObjectDisposedException

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

UnauthorizedAccessException

Kullanıcı gerekli kayıt defteri haklarına sahip değil.

Örnekler

Bu kod örneği, RegistryKey sınıfı için 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. Uyarı sağlanamaz. Bir alt anahtarı yalnızca alt alt anahtarı olmadığında silmek istiyorsanız DeleteSubKey yöntemini kullanın.

Ayrıca bkz.

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