RegistryKey.DeleteValue Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Win32
Assembly:
Microsoft.Win32.Registry.dll
Assembly:
mscorlib.dll

Supprime la valeur spécifiée de cette clé et lève une exception si la valeur est introuvable.

Surcharges

DeleteValue(String)

Supprime la valeur spécifiée de cette clé.
DeleteValue(String, Boolean)

Supprime la valeur spécifiée de cette clé et spécifie si une exception est levée lorsque la valeur est introuvable.

DeleteValue(String)

Source:
RegistryKey.cs

Supprime la valeur spécifiée de cette clé.

public:
 void DeleteValue(System::String ^ name);
public void DeleteValue (string name);
member this.DeleteValue : string -> unit
Public Sub DeleteValue (name As String)

Paramètres

name
String

Nom de la valeur à supprimer.

Exceptions

ArgumentException

name n'est pas une référence valide à une valeur.

SecurityException

L'utilisateur n'a pas les autorisations requises pour supprimer la valeur.

ObjectDisposedException

Le RegistryKey en cours de manipulation est fermé (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

Le RegistryKey en cours de manipulation est en lecture seule.

Exemples

Cet exemple de code fait partie d’un exemple plus grand fourni pour la 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()

Voir aussi

S’applique à

DeleteValue(String, Boolean)

Source:
RegistryKey.cs

Supprime la valeur spécifiée de cette clé et spécifie si une exception est levée lorsque la valeur est introuvable.

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)

Paramètres

name
String

Nom de la valeur à supprimer.

throwOnMissingValue
Boolean

Indique si une exception doit être déclenchée lorsque la valeur spécifiée est introuvable. Si cet argument a la valeur true et que la valeur spécifiée n'existe pas, une exception est levée. Si cet argument a la valeur false et que la valeur spécifiée n'existe pas, aucune action n'est entreprise.

Exceptions

ArgumentException

name n'est pas une référence valide à une valeur et throwOnMissingValue est true.

- ou -

name a la valeur null.

SecurityException

L'utilisateur n'a pas les autorisations requises pour supprimer la valeur.

ObjectDisposedException

Le RegistryKey en cours de manipulation est fermé (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

Le RegistryKey en cours de manipulation est en lecture seule.

Remarques

Si throwOnMissingValue a falsela valeur , il n’existe aucun moyen de savoir si la suppression a réussi, sans essayer d’accéder ultérieurement à la valeur qui vient d’être supprimée. Par conséquent, soyez prudent lorsque vous supprimez des valeurs du Registre de cette manière.

Voir aussi

S’applique à