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
| 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 erforderlichen Berechtigungen, um den Wert zu löschen.
Der zu bearbeitende RegistryKey ist geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).
Der zu bearbeitende RegistryKey ist 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 true ist und der angegebene Wert nicht vorhanden ist, wird eine Ausnahme ausgelöst. Wenn dieses Argument false ist und der angegebene Wert nicht vorhanden ist, findet keine Aktion statt.
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 erforderlichen Berechtigungen, um den Wert zu löschen.
Der zu bearbeitende RegistryKey ist geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).
Der zu bearbeitende RegistryKey ist schreibgeschützt.
Hinweise
Wenn throwOnMissingValue dies der Wert ist false, gibt es keine Möglichkeit, zu sagen, ob der Löschvorgang erfolgreich war, ohne anschließend zu versuchen, auf den gerade gelöschten Wert zuzugreifen. Gehen Sie daher vorsichtig vor, wenn Sie Werte auf diese Weise aus der Registrierung löschen.
