RegistryKey.DeleteValue Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
name
n'est pas une référence valide à une valeur.
L'utilisateur n'a pas les autorisations requises pour supprimer la valeur.
Le RegistryKey en cours de manipulation est fermé (les clés fermées ne sont pas accessibles).
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
name
n'est pas une référence valide à une valeur et throwOnMissingValue
est true
.
- ou -
name
a la valeur null
.
L'utilisateur n'a pas les autorisations requises pour supprimer la valeur.
Le RegistryKey en cours de manipulation est fermé (les clés fermées ne sont pas accessibles).
Le RegistryKey en cours de manipulation est en lecture seule.
Remarques
Si throwOnMissingValue
a false
la 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.