GetAllSettings, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Retourne une liste de paramètres de clé et leurs valeurs respectives (créées à l'origine avec SaveSetting) pour une application dans la base de registres de Windows.

L'utilisation de la fonctionnalité My vous permet une meilleure productivité et de meilleures performances dans les opérations de Registre que GetAllSettings. Pour plus d'informations, consultez My.Computer.Registry, objet.

Public Function GetAllSettings( _
   ByVal AppName As String, _ 
   ByVal Section As String _
) As String(,)

Paramètres

AppName
Requis. Expression String contenant le nom de l'application ou du projet dont les paramètres de clé sont demandés.
Section
Requis. Expression String qui contient le nom de la section dont les paramètres de clé sont demandés. GetAllSettings retourne un objet qui contient un tableau de chaînes à deux dimensions. Les chaînes contiennent tous les paramètres de clé dans la section spécifiée ainsi que leurs valeurs correspondantes.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	L'utilisateur n'est pas connecté.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

GetAllSettings retourne un Object non initialisé si AppName ou Section n'existe pas.

GetAllSettings 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 de Registre accessibles via un processus non interactif (tel que Mtx.exe) doivent être stockés au-dessous des clés de Registre HKEY_LOCAL_MACHINE\Software\ ou HKEY_USER\DEFAULT\Software.

Exemple

Cet exemple utilise d'abord la fonction SaveSetting pour entrer des données dans la base de registres de Windows pour l'application spécifiée en tant que AppName, puis utilise la fonction GetAllSettings pour afficher les paramètres. Notez que les noms d'applications et les noms Section ne peuvent pas être récupérés avec GetAllSettings. Enfin, la fonction DeleteSetting supprime les entrées de l'application.

' Object to hold 2-dimensional array returned by GetAllSettings.
' Integer to hold counter.
Dim MySettings(,) As String
Dim intSettings As Integer
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Retrieve the settings.
MySettings = GetAllSettings("MyApp", "Startup")
For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
   WriteLine(1, MySettings(intSettings, 0))
   WriteLine(1, MySettings(intSettings, 1))
Next intSettings
DeleteSetting("MyApp")