RegistryKey.DeleteValue Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht den angegebenen Wert aus diesem Schlüssel und löst eine Ausnahme aus, wenn der Wert nicht gefunden wird.
Überlädt
| Name | Beschreibung |
|---|---|
| DeleteValue(String) |
Löscht den angegebenen Wert aus diesem Schlüssel. |
| DeleteValue(String, Boolean) |
Löscht den angegebenen Wert aus diesem Schlüssel und gibt an, ob eine Ausnahme ausgelöst wird, wenn der Wert nicht gefunden wird. |
DeleteValue(String)
- Quelle:
- RegistryKey.cs
Löscht den angegebenen Wert aus diesem Schlüssel.
public:
void DeleteValue(System::String ^ name);public void DeleteValue(string name);member this.DeleteValue : string -> unitPublic Sub DeleteValue (name As String)Parameter
- name
- String
Der Name des zu löschenden Werts.
Ausnahmen
name ist kein gültiger Verweis auf einen Wert.
Der Benutzer verfügt nicht über die zum Löschen des Werts erforderlichen Berechtigungen.
Die RegistryKey Bearbeitung wird geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).
Die RegistryKey Bearbeitung erfolgt schreibgeschützt.
Beispiele
Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die RegistryKey Klasse bereitgestellt wird.
// 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()
Weitere Informationen
Gilt für:
DeleteValue(String, Boolean)
- Quelle:
- RegistryKey.cs
Löscht den angegebenen Wert aus diesem Schlüssel und gibt an, ob eine Ausnahme ausgelöst wird, wenn der Wert nicht gefunden wird.
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)Parameter
- name
- String
Der Name des zu löschenden Werts.
- throwOnMissingValue
- Boolean
Gibt an, ob eine Ausnahme ausgelöst werden soll, wenn der angegebene Wert nicht gefunden werden kann. Wenn dieses Argument vorhanden ist und der angegebene Wert nicht vorhanden ist true , wird eine Ausnahme ausgelöst. Wenn dieses Argument vorhanden ist und der angegebene Wert nicht vorhanden ist false , wird keine Aktion ausgeführt.
Ausnahmen
name ist kein gültiger Verweis auf einen Wert und throwOnMissingValue ist true.
-oder-
name ist null.
Der Benutzer verfügt nicht über die zum Löschen des Werts erforderlichen Berechtigungen.
Die RegistryKey Bearbeitung wird geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).
Die RegistryKey Bearbeitung erfolgt schreibgeschützt.
Hinweise
Wenn throwOnMissingValue ja false, gibt es keine Möglichkeit, zu ermitteln, ob der Löschvorgang erfolgreich war, ohne anschließend zu versuchen, auf den soeben gelöschten Wert zuzugreifen. Verwenden Sie daher Vorsicht beim Löschen von Werten aus der Registrierung auf diese Weise.
