RegistryKey.DeleteSubKey Metode

Referensi

Definisi

Ruang nama:: Microsoft.Win32

Rakitan:: Microsoft.Win32.Registry.dll

Rakitan:: mscorlib.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menghapus sub-kunci yang ditentukan.

Overload

DeleteSubKey(String)	Menghapus sub-kunci yang ditentukan.
DeleteSubKey(String, Boolean)	Menghapus subkunjung yang ditentukan, dan menentukan apakah pengecualian dimunculkan jika subkunjung tidak ditemukan.

DeleteSubKey(String)

Sumber:: RegistryKey.cs

Menghapus sub-kunci yang ditentukan.

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

public void DeleteSubKey (string subkey);

member this.DeleteSubKey : string -> unit

Public Sub DeleteSubKey (subkey As String)

Parameter

subkey: String

Nama subkunjuk yang akan dihapus. String ini tidak peka huruf besar/kecil.

Pengecualian

InvalidOperationException

yang subkey memiliki kunci bawah kunci anak.

ArgumentException

Parameter subkey tidak menentukan kunci registri yang valid.

ArgumentNullException

subkey is null

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk menghapus kunci.

ObjectDisposedException

Yang RegistryKey sedang dimanipulasi ditutup (kunci tertutup tidak dapat diakses).

UnauthorizedAccessException

Pengguna tidak memiliki hak registri yang diperlukan.

Contoh

Contoh berikut menunjukkan cara menggunakan DeleteSubKey.

using namespace System;
using namespace Microsoft::Win32;

public ref class RegKeyDel
{
public:
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey^ test9999 =
            Registry::CurrentUser->CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        RegistryKey^ testName = test9999->CreateSubKey("TestName");
        RegistryKey^ testSettings = test9999->CreateSubKey("TestSettings");

        // Create data for the TestSettings subkey.
        testSettings->SetValue("Language", "French");
        testSettings->SetValue("Level", "Intermediate");
        testSettings->SetValue("ID", 123);

        // delete the subkey "TestName"
        test9999->DeleteSubKey("TestName");
        // delete everything under and including "Test9999"
        Registry::CurrentUser->DeleteSubKeyTree("Test9999");
    }
};

int main()
{
    RegKeyDel::Main();
}

using System;
using Microsoft.Win32;

class RegKeyDel
{
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey test9999 =
            Registry.CurrentUser.CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        RegistryKey testName = test9999.CreateSubKey("TestName");
        RegistryKey testSettings = test9999.CreateSubKey("TestSettings");

        // Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French");
        testSettings.SetValue("Level", "Intermediate");
        testSettings.SetValue("ID", 123);

        // delete the subkey "TestName"
        test9999.DeleteSubKey("TestName");
        // delete everything under and including "Test9999"
        Registry.CurrentUser.DeleteSubKeyTree("Test9999");
    }
}

Imports Microsoft.Win32

Public Class RegKeyDel
    Public Shared Sub Main()
        ' Create a subkey named Test9999 under HKEY_CURRENT_USER.
        Dim test9999 As RegistryKey = _
            Registry.CurrentUser.CreateSubKey("Test9999")
        ' Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        ' keys are disposed when execution exits the using statement.
        Dim testName As RegistryKey = test9999.CreateSubKey("TestName")
        Dim testSettings As RegistryKey = test9999.CreateSubKey("TestSettings")

        ' Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French")
        testSettings.SetValue("Level", "Intermediate")
        testSettings.SetValue("ID", 123)

        ' delete the subkey "TestName"
        test9999.DeleteSubKey("TestName")
        ' delete everything under and including "Test9999"
        Registry.CurrentUser.DeleteSubKeyTree("Test9999")
    End Sub
End Class

Keterangan

Untuk menghapus subkey anak, gunakan DeleteSubKeyTree.

Berhati-hatilah saat menghapus kunci registri.

Lihat juga

Berlaku untuk

DeleteSubKey(String, Boolean)

Sumber:: RegistryKey.cs

Menghapus subkunjung yang ditentukan, dan menentukan apakah pengecualian dimunculkan jika subkunjung tidak ditemukan.

public:
 void DeleteSubKey(System::String ^ subkey, bool throwOnMissingSubKey);

public void DeleteSubKey (string subkey, bool throwOnMissingSubKey);

member this.DeleteSubKey : string * bool -> unit

Public Sub DeleteSubKey (subkey As String, throwOnMissingSubKey As Boolean)

Parameter

subkey: String

Nama subkunjuk yang akan dihapus. String ini tidak peka huruf besar/kecil.

throwOnMissingSubKey: Boolean

Menunjukkan apakah pengecualian harus dinaikkan jika subkunjung yang ditentukan tidak dapat ditemukan. Jika argumen ini adalah true dan subkunjung yang ditentukan tidak ada, pengecualian akan dimunculkan. Jika argumen ini adalah false dan subkuntah yang ditentukan tidak ada, tidak ada tindakan yang diambil.