RegistryKey.DeleteValue Método

  • Referência

Definição

Namespace:
Microsoft.Win32
Assembly:
Microsoft.Win32.Registry.dll
Assembly:
mscorlib.dll

Exclui o valor especificado dessa chave e gera uma exceção se o valor não é encontrado.

Sobrecargas

DeleteValue(String)

Exclui o valor especificado dessa chave.
DeleteValue(String, Boolean)

Exclui o valor especificado dessa chave e especifica se uma exceção será gerada se o valor não for encontrado.

DeleteValue(String)

Origem:
RegistryKey.cs

Exclui o valor especificado dessa chave.

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

Parâmetros

name
String

O nome do valor a ser excluído.

Exceções

ArgumentException

O name não é uma referência válida para um valor.

SecurityException

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

ObjectDisposedException

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

UnauthorizedAccessException

O RegistryKey manipulado é somente leitura.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a RegistryKey classe .

// Delete the ID value.
testSettings = test9999->OpenSubKey( "TestSettings", true );
testSettings->DeleteValue( "id" );

// Verify the deletion.
Console::WriteLine( dynamic_cast<String^>(testSettings->GetValue(  "id", "ID not found." )) );
testSettings->Close();

using(RegistryKey
    testSettings = test9999.OpenSubKey("TestSettings", true))
{
    // Delete the ID value.
    testSettings.DeleteValue("id");

    // Verify the deletion.
    Console.WriteLine((string)testSettings.GetValue(
        "id", "ID not found."));
}

' Delete the ID value.
testSettings = test9999.OpenSubKey("TestSettings", True)
testSettings.DeleteValue("id")

' Verify the deletion.
Console.WriteLine(CType(testSettings.GetValue( _
    "id", "ID not found."), String))
testSettings.Close()

Confira também

Aplica-se a

DeleteValue(String, Boolean)

Origem:
RegistryKey.cs

Exclui o valor especificado dessa chave e especifica se uma exceção será gerada se o valor não for encontrado.

public:
 void DeleteValue(System::String ^ name, bool throwOnMissingValue);
public void DeleteValue (string name, bool throwOnMissingValue);
member this.DeleteValue : string * bool -> unit
Public Sub DeleteValue (name As String, throwOnMissingValue As Boolean)

Parâmetros

name
String

O nome do valor a ser excluído.

throwOnMissingValue
Boolean

Indica se uma exceção deverá ser gerada se o valor especificado não puder ser encontrado. Se esse argumento for true e o valor especificado não existir, uma exceção será gerada. Se esse argumento for false e o valor especificado não existir, nenhuma ação será tomada.

Exceções

ArgumentException

name não é uma referência válida para um valor e throwOnMissingValue é true.

- ou -

name é null.

SecurityException

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

ObjectDisposedException

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

UnauthorizedAccessException

O RegistryKey manipulado é somente leitura.

Comentários

Se throwOnMissingValue for false, não há como saber se a exclusão foi bem-sucedida, sem tentar acessar o valor apenas excluído. Portanto, tenha cuidado ao excluir valores do registro dessa maneira.

Confira também

Aplica-se a