共用方式為


RegistryKey.DeleteSubKey 方法

定義

刪除指定的子機碼。

多載

DeleteSubKey(String)

刪除指定的子機碼。

DeleteSubKey(String, Boolean)

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

DeleteSubKey(String)

來源:
RegistryKey.cs

刪除指定的子機碼。

public:
 void DeleteSubKey(System::String ^ subkey);
public void DeleteSubKey (string subkey);
member this.DeleteSubKey : string -> unit
Public Sub DeleteSubKey (subkey As String)

參數

subkey
String

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

例外狀況

subkey具有子子機碼。

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

subkeynull

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

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

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

範例

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

刪除登錄機碼時請小心。

另請參閱

適用於

DeleteSubKey(String, Boolean)

來源:
RegistryKey.cs

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

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,而指定的子機碼不存在時,則不採取任何動作。

例外狀況

subkey 有子系子機碼。

subkey 沒有指定有效的登錄機碼,而且 throwOnMissingSubKeytrue

subkeynull

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

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

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

備註

若要刪除子子機碼,請使用 DeleteSubKeyTree

刪除登錄機碼時請小心。

另請參閱

適用於