RegistryKey.DeleteValue Método

Definición

Espacio de nombres:

Microsoft.Win32

Ensamblado:

Microsoft.Win32.Registry.dll

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)

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

ArgumentException

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

SecurityException

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

ObjectDisposedException

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

UnauthorizedAccessException

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

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount

DeleteValue(String, Boolean)

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

ArgumentException

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

o bien

name es null.

SecurityException

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

ObjectDisposedException

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

UnauthorizedAccessException

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

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount