RegistryKey.DeleteSubKey Método

Referência

Definição

Namespace:: Microsoft.Win32

Assembly:: Microsoft.Win32.Registry.dll

Assembly:: mscorlib.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Exclui a subchave especificada.

Sobrecargas

DeleteSubKey(String)	Exclui a subchave especificada.
DeleteSubKey(String, Boolean)	Exclui a subchave especificada e define se uma exceção será gerada se a subchave não for encontrada.

DeleteSubKey(String)

Origem:: RegistryKey.cs

Exclui a subchave especificada.

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

public void DeleteSubKey (string subkey);

member this.DeleteSubKey : string -> unit

Public Sub DeleteSubKey (subkey As String)

Parâmetros

subkey: String

O nome da subchave a ser excluída. Esta cadeia de caracteres não diferencia maiúsculas de minúsculas.

Exceções

InvalidOperationException

O subkey tem subchaves filho.

ArgumentException

O subkey parâmetro não especifica uma chave do Registro válida.

ArgumentNullException

subkey é null

SecurityException

O usuário não tem as permissões necessárias para excluir a chave.

ObjectDisposedException

O RegistryKey que está sendo manipulado é fechado (chaves fechadas não podem ser acessadas).

UnauthorizedAccessException

O usuário não tem os direitos do Registro necessários.

Exemplos

O exemplo a seguir demonstra como usar 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

Comentários

Para excluir subchaves filho, use DeleteSubKeyTree.

Tenha cuidado ao excluir chaves do Registro.

Confira também

Aplica-se a

DeleteSubKey(String, Boolean)

Origem:: RegistryKey.cs

Exclui a subchave especificada e define se uma exceção será gerada se a subchave não for encontrada.

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)

Parâmetros

subkey: String

O nome da subchave a ser excluída. Esta cadeia de caracteres não diferencia maiúsculas de minúsculas.

throwOnMissingSubKey: Boolean

Indica se uma exceção deverá ser gerada se a subchave especificada não puder ser encontrada. Se esse argumento for true e a subchave especificada não existir, uma exceção será gerada. Se esse argumento for false e a subchave especificada não existir, nenhuma ação será gerada.