RegistryKey.DeleteValue Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exclui o valor especificado dessa chave e gera uma exceção se o valor não é encontrado.
Sobrecargas
| DeleteValue(String) |
Exclui o valor especificado dessa chave. |
| DeleteValue(String, Boolean) |
Exclui o valor especificado dessa chave e especifica se uma exceção será gerada se o valor não for encontrado. |
DeleteValue(String)
- Origem:
- RegistryKey.cs
Exclui o valor especificado dessa 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 ser excluído.
Exceções
O name não é uma referência válida para um valor.
O usuário não tem as permissões necessárias para excluir o valor.
O RegistryKey que está sendo manipulado é fechado (chaves fechadas não podem ser acessadas).
O RegistryKey manipulado é somente 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()
Confira também
Aplica-se a
DeleteValue(String, Boolean)
- Origem:
- RegistryKey.cs
Exclui o valor especificado dessa chave e especifica se uma exceção será gerada se o valor não for 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 ser excluído.
- throwOnMissingValue
- Boolean
Indica se uma exceção deverá ser gerada se o valor especificado não puder ser encontrado. Se esse argumento for true e o valor especificado não existir, uma exceção será gerada. Se esse argumento for false e o valor especificado não existir, nenhuma ação será tomada.
Exceções
name não é uma referência válida para um valor e throwOnMissingValue é true.
- ou -
name é null.
O usuário não tem as permissões necessárias para excluir o valor.
O RegistryKey que está sendo manipulado é fechado (chaves fechadas não podem ser acessadas).
O RegistryKey manipulado é somente leitura.
Comentários
Se throwOnMissingValue for false, não há como saber se a exclusão foi bem-sucedida, sem tentar acessar o valor apenas excluído. Portanto, tenha cuidado ao excluir valores do registro dessa maneira.
