RegistryKey.DeleteValue Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verwijdert u de opgegeven waarde uit deze sleutel en genereert u een uitzondering als de waarde niet wordt gevonden.
Overloads
| Name | Description |
|---|---|
| DeleteValue(String) |
Hiermee verwijdert u de opgegeven waarde uit deze sleutel. |
| DeleteValue(String, Boolean) |
Hiermee verwijdert u de opgegeven waarde uit deze sleutel en geeft u op of er een uitzondering wordt gegenereerd als de waarde niet wordt gevonden. |
DeleteValue(String)
Hiermee verwijdert u de opgegeven waarde uit deze sleutel.
public:
void DeleteValue(System::String ^ name);public void DeleteValue(string name);member this.DeleteValue : string -> unitPublic Sub DeleteValue (name As String)Parameters
- name
- String
De naam van de te verwijderen waarde.
Uitzonderingen
name is geen geldige verwijzing naar een waarde.
De gebruiker beschikt niet over de vereiste machtigingen om de waarde te verwijderen.
Het RegistryKey bewerken is gesloten (gesloten sleutels kunnen niet worden geopend).
Het RegistryKey bewerken ervan is alleen-lezen.
Voorbeelden
Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de RegistryKey klasse.
// 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()
Zie ook
Van toepassing op
DeleteValue(String, Boolean)
Hiermee verwijdert u de opgegeven waarde uit deze sleutel en geeft u op of er een uitzondering wordt gegenereerd als de waarde niet wordt gevonden.
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)Parameters
- name
- String
De naam van de te verwijderen waarde.
- throwOnMissingValue
- Boolean
Geeft aan of er een uitzondering moet worden gegenereerd als de opgegeven waarde niet kan worden gevonden. Als dit argument is true en de opgegeven waarde niet bestaat, wordt er een uitzondering gegenereerd. Als dit argument is false en de opgegeven waarde niet bestaat, wordt er geen actie ondernomen.
Uitzonderingen
name is geen geldige verwijzing naar een waarde en throwOnMissingValue is true.
– of –
name is null.
De gebruiker beschikt niet over de vereiste machtigingen om de waarde te verwijderen.
Het RegistryKey bewerken is gesloten (gesloten sleutels kunnen niet worden geopend).
Het RegistryKey bewerken ervan is alleen-lezen.
Opmerkingen
Als throwOnMissingValue dat zo is false, is er geen manier om te zien of de verwijdering is geslaagd, zonder vervolgens toegang te krijgen tot de waarde die u zojuist hebt verwijderd. Wees daarom voorzichtig bij het verwijderen van waarden uit het register op deze manier.