RegistryKey.DeleteValue Método

Definição

Namespace:: Microsoft.Win32

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 o valor especificado dessa chave e gera uma exceção se o valor não for encontrado.

Sobrecargas

Nome	Description
DeleteValue(String)	Exclui o valor especificado dessa chave.
DeleteValue(String, Boolean)	Exclui o valor especificado dessa chave e especifica se uma exceção é gerada se o valor não for encontrado.

DeleteValue(String)

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

name não é uma referência válida a 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 que está sendo 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)

Exclui o valor especificado dessa chave e especifica se uma exceção é 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 deve 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 a um valor e throwOnMissingValue é true.

-ou-

name é null.