Interaction.GetSetting(String, String, String, String) Méthode

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Interaction.vb

Source:: Interaction.vb

Source:: Interaction.vb

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.

Retourne une valeur de paramètre de clé à partir de l’entrée d’une application dans le Registre Windows. La fonctionnalité My vous offre une productivité et des performances supérieures à GetAllSettings. Pour plus d’informations, consultez Registry.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? GetSetting(string AppName, string Section, string Key, string? Default = "");

public static string GetSetting(string AppName, string Section, string Key, string Default = "");

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetSetting : string * string * string * string -> string

static member GetSetting : string * string * string * string -> string

Public Function GetSetting (AppName As String, Section As String, Key As String, Optional Default As String = "") As String

Paramètres

AppName: String

Obligatoire. String expression contenant le nom de l’application ou du projet dont le paramètre de clé est demandé.

Section: String

Obligatoire. String expression contenant le nom de la section dans laquelle le paramètre de clé est trouvé.

Key: String

Obligatoire. String expression contenant le nom du paramètre de clé à retourner.

Default: String

Optionnel. Expression contenant la valeur à retourner si aucune valeur n’est définie dans le paramètre Key. En cas d’omission, Default est supposé être une chaîne de longueur nulle (« »).

Retours

String

Valeur de paramètre de clé à partir de l’entrée d’une application dans le Registre Windows.

La fonctionnalité My vous offre une productivité et des performances supérieures à GetAllSettings.

Attributs: SupportedOSPlatformAttribute

Exceptions

ArgumentException

Un ou plusieurs arguments ne sont pas String expressions, ou l’utilisateur n’est pas connecté.

Exemples

Cet exemple utilise d’abord la fonction SaveSetting pour créer des entrées dans le Registre Windows pour l’application spécifiée en tant que AppName, puis utilise la fonction GetSetting pour afficher l’un des paramètres. Étant donné que l’argument Default est spécifié, une certaine valeur est garantie d’être retournée. Notez que Section noms ne peuvent pas être récupérés avec GetSetting. Enfin, la fonction DeleteSetting supprime toutes les entrées de l’application.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
Console.WriteLine(GetSetting("MyApp", "Startup", "Left", "25"))
DeleteSetting("MyApp")

Remarques

Si l’un des éléments nommés dans les arguments GetSetting n’existe pas, GetSetting retourne une valeur de Default.

Étant donné qu’elle fonctionne sous la clé de Registre HKEY_LOCAL_USER, qui n’est pas active tant qu’un utilisateur ne se connecte pas de manière interactive, GetSetting exige qu’un utilisateur soit connecté.

Les paramètres de Registre à accéder à partir d’un processus non interactif (par exemple, Mtx.exe) doivent être stockés sous les clés de Registre HKEY_LOCAL_MACHINE\Software\ ou HKEY_USER\DEFAULT\Software.

GetSetting nécessite ReadRegistryPermission.

S’applique à

Produit	Versions
.NET	5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Partage via