RegistryKey.DeleteValue Methode

  • Referenz

Definition

Namespace:
Microsoft.Win32
Assembly:
Microsoft.Win32.Registry.dll
Assembly:
mscorlib.dll

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 -> unit
Public Sub DeleteValue (name As String)

Parameter

name
String

Der Name des zu löschenden Werts.

Ausnahmen

ArgumentException

name ist kein gültiger Verweis auf einen Wert.

SecurityException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen, um den Wert zu löschen.

ObjectDisposedException

Der zu bearbeitende RegistryKey ist geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).

UnauthorizedAccessException

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 -> unit
Public 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

ArgumentException

name ist kein gültiger Verweis auf einen Wert, und throwOnMissingValue ist true.

- oder -

name ist null.

SecurityException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen, um den Wert zu löschen.

ObjectDisposedException

Der zu bearbeitende RegistryKey ist geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).

UnauthorizedAccessException

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.

Weitere Informationen

Gilt für: