My.Computer.Registry.GetValue, méthode

Mise à jour : novembre 2007

Obtient une valeur d'une clé de Registre.

' Usage
Dim value As Object = My.Computer.Registry.GetValue(keyName ,valueName ,defaultValue)
' Declaration
Public Function GetValue( _
   ByVal keyName As String, _
   ByVal valueName As String, _
   ByVal defaultValue As Object _
) As Object

Paramètres

• keyName
  String. Clé à partir de laquelle la valeur sera récupérée. Requis.

• valueName
  String. Valeur à récupérer. Requis.

• defaultValue
  Object. Valeur par défaut à fournir si la valeur n'existe pas. Requis.

Notes

valueName n'est pas sensible à la casse.

Une clé de Registre peut avoir une valeur qui n'est pas associée à un nom. Quand cette valeur sans nom est affichée dans l'Éditeur du Registre, la chaîne "(Default)" apparaît à la place d'un nom. Pour récupérer cette valeur sans nom, spécifiez soit null, soit la chaîne vide ("") pour valueName.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

• Le nom de la clé est Nothing (ArgumentNullException).

• L'utilisateur n'a pas l'autorisation de lire à partir de clés de Registre (SecurityException).

• Le nom de la clé dépasse la limite de 255 caractères (ArgumentException).

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode GetValue.

Exemple

Cet exemple lit la valeur Name de HKEY_CURRENT_USER\Software\MyApp et l'affiche dans un MessageBox.

Dim readValue As Object
readValue = My.Computer.Registry.GetValue("HKEY_CURRENT_USER\Software\MyApp", "Name", Nothing)
MsgBox("The value is " & CStr(readValue))

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :RegistryProxy (fournit l'accès à Registry)

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Autorisations

Aucune autorisation n'est requise.

Voir aussi

Tâches

Dépannage : manipulation du Registre

Concepts

Tâches courantes relatives au Registre

Sécurité et Registre

Lecture et écriture dans le Registre à l'aide de My

Référence

My.Computer.Registry, objet

GetValue