RegistryKey.DeleteSubKey 方法

定義

命名空間:

Microsoft.Win32

組件:

Microsoft.Win32.Registry.dll

刪除指定的子機碼。

多載

DeleteSubKey(String)	刪除指定的子機碼。
DeleteSubKey(String, Boolean)	刪除指定的子機碼，並且指定在找不到該子機碼時是否引發例外狀況。

DeleteSubKey(String)

刪除指定的子機碼。

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

public void DeleteSubKey (string subkey);

member this.DeleteSubKey : string -> unit

Public Sub DeleteSubKey (subkey As String)

參數

subkey

String

要刪除的子機碼名稱。 這個字串不會區分大小寫。

例外狀況

InvalidOperationException

subkey具有子子機碼。

ArgumentException

參數 subkey 未指定有效的登錄機碼。

ArgumentNullException

subkey 是 null

SecurityException

使用者沒有刪除機碼所需的使用權限。

ObjectDisposedException

正接受管理的 RegistryKey 已經關閉 (關閉的機碼無法存取)。

UnauthorizedAccessException

使用者沒有必要的登錄權限。

範例

下列範例示範如何使用 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

備註

若要刪除子子機碼，請使用 DeleteSubKeyTree。

刪除登錄機碼時請小心。

另請參閱

• DeleteSubKeyTree(String)
• CreateSubKey(String)
• DeleteValue(String)
• GetSubKeyNames()

DeleteSubKey(String, Boolean)

刪除指定的子機碼，並且指定在找不到該子機碼時是否引發例外狀況。

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)

參數

subkey

String

要刪除的子機碼名稱。 這個字串不會區分大小寫。

throwOnMissingSubKey

Boolean

表示如果找不到指定子機碼時，是否引發例外狀況。 如果這個引數為 true，而指定的子機碼不存在時，則會引發例外狀況。 如果這個引數為 false，而指定的子機碼不存在時，則不採取任何動作。

例外狀況

InvalidOperationException

subkey 有子系子機碼。

ArgumentException

subkey 沒有指定有效的登錄機碼，而且 throwOnMissingSubKey 為 true。

ArgumentNullException

subkey 為 null。

SecurityException

使用者沒有刪除機碼所需的使用權限。

ObjectDisposedException

正接受管理的 RegistryKey 已經關閉 (關閉的機碼無法存取)。

UnauthorizedAccessException

使用者沒有必要的登錄權限。

備註

若要刪除子子機碼，請使用 DeleteSubKeyTree。

刪除登錄機碼時請小心。

另請參閱

• DeleteSubKeyTree(String)
• CreateSubKey(String)
• DeleteValue(String)
• GetSubKeyNames()