Aracılığıyla paylaş


RegistryKey.DeleteSubKeyTree Yöntem

Tanım

İ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)

Kaynak:
RegistryKey.cs

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

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.

Öznitelikler

Özel durumlar

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.

subkey, null değeridir.

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

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

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

Şunlara uygulanır

DeleteSubKeyTree(String)

Kaynak:
RegistryKey.cs

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

subkey, null değeridir.

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

-veya-

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

G/Ç hatası oluştu.

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

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

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.

Şunlara uygulanır