RegistryKey.DeleteValue Método

Definición

Espacio de nombres:: Microsoft.Win32

Ensamblado:: Microsoft.Win32.Registry.dll

Ensamblado:: mscorlib.dll

Paquete:: Microsoft.Win32.Registry v5.0.0

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Sobrecargas

Nombre	Description
DeleteValue(String)	Elimina el valor especificado de esta clave.
DeleteValue(String, Boolean)	Elimina el valor especificado de esta clave y especifica si se produce una excepción si 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

ArgumentException

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

SecurityException

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

ObjectDisposedException

El RegistryKey objeto que se está manipulando está cerrado (no se puede acceder a las claves cerradas).

UnauthorizedAccessException

El RegistryKey objeto que se está manipulando es de solo lectura.

Ejemplos

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

// 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 y especifica si se produce una excepción si 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 se debe generar una excepción si no se encuentra 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 realiza ninguna acción.

Excepciones

ArgumentException

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

O bien

name es null.