My.Application.GetEnvironmentVariable, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne la valeur de la variable d'environnement spécifiée.

' Usage
Dim value As String = My.Application.GetEnvironmentVariable(name)
' Declaration
Public Function GetEnvironmentVariable( _
   ByVal name As String _
) As String

Paramètres

name
String qui contient le nom de la variable d'environnement.

Valeur de retour

String qui contient la valeur de la variable d'environnement portant le nom name.

Exceptions

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

L'argument name a la valeur Nothing (ArgumentNullException).
La variable d'environnement spécifiée par name n'existe pas (ArgumentException).
Le code appelant ne dispose pas de EnvironmentPermission avec un accès Read (SecurityException).

Notes

La méthode My.Application.GetEnvironmentVariable retourne la variable d'environnement portant le nom name. Cette méthode est semblable à Environment.GetEnvironmentVariable(String), sauf que celle-ci lève une exception si la variable d'environnement spécifiée par name n'existe pas.

Exemple

Cet exemple utilise la méthode My.Application.GetEnvironmentVariable pour obtenir et afficher la valeur de la variable d'environnement PATH, si elle est disponible. Sinon, elle affiche un message qui indique que la variable d'environnement PATH n'existe pas.

Private Sub TestGetEnvironmentVariable()
    Try
        MsgBox("PATH = " & My.Application.GetEnvironmentVariable("PATH"))
    Catch ex As System.ArgumentException
        MsgBox("Environment variable 'PATH' does not exist.")
    End Try
End Sub

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :WindowsFormsApplicationBase, ApplicationBase

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

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Non
Service Windows	Oui
Site Web	Non

Autorisations

Aucune autorisation n'est requise.

Voir aussi

Référence

My.Application, objet

GetEnvironmentVariable

Partager via