Compartir a través de


RegistryKey.DeleteValue Método

Definición

Elimina el valor especificado de esta clave e inicia una excepción si no se encuentra el valor.

Sobrecargas

DeleteValue(String)

Elimina el valor especificado de esta clave.

DeleteValue(String, Boolean)

Elimina el valor especificado de esta clave e indica si se inicia una excepción cuando no se encuentra el valor.

DeleteValue(String)

Source:
RegistryKey.cs

Elimina el valor especificado de esta clave.

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

Nombre del valor que se va a eliminar.

Excepciones

name no es una referencia válida a un valor.

El usuario no tiene los permisos necesarios para eliminar el valor.

La RegistryKey que se ha manipulado está cerrada (no se puede tener acceso a las claves cerradas).

El objeto RegistryKey que se desea manipular es de sólo lectura.

Ejemplos

Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase RegistryKey.

// 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()

Consulte también

Se aplica a

DeleteValue(String, Boolean)

Source:
RegistryKey.cs

Elimina el valor especificado de esta clave e indica si se inicia una excepción cuando no se encuentra el valor.

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

Nombre del valor que se va a eliminar.

throwOnMissingValue
Boolean

Indica si debe producirse una excepción si no se puede encontrar el valor especificado. Si este argumento es true y el valor especificado no existe, se genera una excepción. Si este argumento es false y el valor especificado no existe, no se lleva a cabo ninguna acción.

Excepciones

name no es una referencia válida a un valor y throwOnMissingValue es true.

o bien

name es null.

El usuario no tiene los permisos necesarios para eliminar el valor.

La RegistryKey que se ha manipulado está cerrada (no se puede tener acceso a las claves cerradas).

El objeto RegistryKey que se desea manipular es de sólo lectura.

Comentarios

Si throwOnMissingValue es false, no hay ninguna manera de saber si la eliminación se realizó correctamente, sin intentar acceder posteriormente al valor que acaba de eliminar. Por lo tanto, tenga cuidado al eliminar valores del Registro de esta manera.

Consulte también

Se aplica a