RegistryKey.DeleteValue Método
Definición
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 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 -> unitPublic 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 -> unitPublic 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.
