Interaction.GetAllSettings, méthode

Article
08/21/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 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.

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

Syntaxe

'Déclaration
Public Shared Function GetAllSettings ( _
    AppName As String, _
    Section As String _
) As String(,)
'Utilisation
Dim AppName As String
Dim Section As String
Dim returnValue As String(,)

returnValue = Interaction.GetAllSettings(AppName, Section)

public static string[,] GetAllSettings (
    string AppName,
    string Section
)

public:
static array<String^,2>^ GetAllSettings (
    String^ AppName, 
    String^ Section
)

public static String[,] GetAllSettings (
    String AppName, 
    String Section
)

public static function GetAllSettings (
    AppName : String, 
    Section : String
) : String[,]

Paramètres

AppName
Obligatoire. Expression String contenant le nom de l'application ou du projet dont les paramètres de clé sont demandés.

Section
Obligatoire. Expression String qui contient le nom de la section dont les paramètres de clé sont demandés. GetAllSettings retourne un objet contenant 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.

Valeur de retour

Notes

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

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 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

Cet exemple utilise d'abord la fonction SaveSetting pour entrer des données dans la base de registres Windows pour l'application spécifiée en tant qu'argument 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")

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

GetAllSettings, fonction
DeleteSetting, fonction
GetSetting, fonction
SaveSetting, fonction
Tâches courantes relatives au Registre

Partager via