RegistryKey.DeleteValue Méthode

Définition

Espace de noms:
Microsoft.Win32
Assembly:
Microsoft.Win32.Registry.dll
Assembly:
mscorlib.dll
Paquet:
Microsoft.Win32.Registry v5.0.0

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

Surcharges

Nom Description
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 si 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

La RegistryKey manipulation est fermée (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

L’être RegistryKey manipulé 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 si 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 levée si la valeur spécifiée est introuvable. Si cet argument est true et que la valeur spécifiée n’existe pas, une exception est levée. Si cet argument est false et que la valeur spécifiée n’existe pas, aucune action n’est effectuée.

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

La RegistryKey manipulation est fermée (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

L’être RegistryKey manipulé est en lecture seule.

Remarques

Si throwOnMissingValue c’est falsele cas, il n’existe aucun moyen de savoir si la suppression a réussi, sans essayer par la suite d’accéder à la valeur juste supprimée. Par conséquent, soyez prudent lors de la suppression des valeurs du Registre de cette façon.

Voir aussi

S’applique à