RegistryKey.DeleteValue Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Elimina o valor especificado desta chave e lança uma exceção se o valor não for encontrado.
Sobrecargas
| Name | Description |
|---|---|
| DeleteValue(String) |
Elimina o valor especificado desta chave. |
| DeleteValue(String, Boolean) |
Elimina o valor especificado desta chave e especifica se uma exceção é levantada caso o valor não seja encontrado. |
DeleteValue(String)
- Origem:
- RegistryKey.cs
Elimina o valor especificado desta chave.
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
O nome do valor a eliminar.
Exceções
name não é uma referência válida a um valor.
O utilizador não tem as permissões necessárias para eliminar o valor.
O RegistryKey ser manipulado é fechado (as chaves fechadas não podem ser acedidas).
O RegistryKey ser manipulado é apenas de 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()
Ver também
Aplica-se a
DeleteValue(String, Boolean)
- Origem:
- RegistryKey.cs
Elimina o valor especificado desta chave e especifica se uma exceção é levantada caso o valor não seja encontrado.
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
O nome do valor a eliminar.
- throwOnMissingValue
- Boolean
Indica se uma exceção deve ser levantada caso o valor especificado não possa ser encontrado. Se este argumento for true e o valor especificado não existir, é criada uma exceção. Se este argumento for false e o valor especificado não existir, não é tomada qualquer ação.
Exceções
name não é uma referência válida a um valor e throwOnMissingValue é true.
-ou-
name é null.
O utilizador não tem as permissões necessárias para eliminar o valor.
O RegistryKey ser manipulado é fechado (as chaves fechadas não podem ser acedidas).
O RegistryKey ser manipulado é apenas de leitura.
Observações
Se throwOnMissingValue for false, não há forma de saber se a eliminação foi bem-sucedida, sem tentar posteriormente aceder ao valor acabado de ser eliminado. Por isso, tenha cautela ao eliminar valores do registo desta forma.
