Interaction.DeleteSetting, méthode

Article
08/21/2007

Supprime un paramètre de section ou de clé pour une application dans la base de registres Windows. My permet une meilleure productivité et de meilleures performances dans les opérations de Registre que la fonction DeleteSetting . Pour plus d'informations, consultez My.Computer.Registry, objet.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Sub DeleteSetting ( _
    AppName As String, _
    <OptionalAttribute> Optional Section As String = Nothing, _
    <OptionalAttribute> Optional Key As String = Nothing _
)
'Utilisation
Dim AppName As String
Dim Section As String
Dim Key As String

Interaction.DeleteSetting(AppName, Section, Key)

public static void DeleteSetting (
    string AppName,
    [OptionalAttribute] string Section,
    [OptionalAttribute] string Key
)

public:
static void DeleteSetting (
    String^ AppName, 
    [OptionalAttribute] String^ Section, 
    [OptionalAttribute] String^ Key
)

public static void DeleteSetting (
    String AppName, 
    /** @attribute OptionalAttribute() */ String Section, 
    /** @attribute OptionalAttribute() */ String Key
)

public static function DeleteSetting (
    AppName : String, 
    Section : String, 
    Key : String
)

Paramètres

AppName
Obligatoire. Expression String contenant le nom de l'application ou du projet auquel s'applique le paramètre de section ou de clé.

Section
Obligatoire. Expression String contenant le nom de la section à partir de laquelle le paramètre de clé est supprimé. Si seuls sont spécifiés AppName et Section, la section spécifiée est supprimée avec tous les paramètres de clé connexes.

Key
Facultatif. Expression String contenant le nom du paramètre de clé supprimé.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic DeleteSetting, fonction.

Si tous les arguments sont fournis, le paramètre spécifié est supprimé. Une erreur d'exécution se produit si vous tentez d'utiliser DeleteSetting sur un paramètre de section ou de clé inexistant.

DeleteSetting nécessite qu'un utilisateur soit connecté car elle fonctionne sous la clé de Registre HKEY_LOCAL_USER, qui n'est active que lorsque l'utilisateur se connecte de façon interactive.

Les paramètres du Registre accessibles à partir d'un processus non interactif (tel que mtx.exe) doivent être stockés sous la clé de Registre HKEY_LOCAL_MACHINE\Software\ ou HKEY_USER\DEFAULT\Software.

Exemple

L'exemple suivant utilise d'abord la procédure SaveSetting pour entrer des données dans la base de registres Windows pour l'application MyApp, puis utilise la fonction DeleteSetting pour les supprimer. Dans la mesure où aucun argument Key n'est spécifié, l'ensemble de la section Startup est supprimé, y compris le nom de la section et toutes ses clés.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

Interaction, classe
Membres Interaction
Microsoft.VisualBasic, espace de noms
ArgumentException Class

Autres ressources

DeleteSetting, fonction
GetAllSettings, fonction
GetSetting, fonction
SaveSetting, fonction

Partager via