My.Application.GetEnvironmentVariable-Methode
Aktualisiert: November 2007
Gibt den Wert der angegebenen Umgebungsvariablen zurück.
' Usage
Dim value As String = My.Application.GetEnvironmentVariable(name)
' Declaration
Public Function GetEnvironmentVariable( _
ByVal name As String _
) As String
Parameter
- name
Ein String, der den Namen der Umgebungsvariablen enthält.
Rückgabewert
Ein String, der den Wert der Umgebungsvariablen mit dem Namen name enthält.
Ausnahmen
Die folgenden Bedingungen können einen Ausnahmefehler verursachen:
Das name-Argument ist Nothing (ArgumentNullException).
Die von name angegebene Umgebungsvariable ist nicht vorhanden (ArgumentException).
Der aufrufende Code verfügt über keine EnvironmentPermission mit Read-Zugriff (SecurityException).
Hinweise
Die My.Application.GetEnvironmentVariable-Methode gibt die Umgebungsvariable mit dem Namen name zurück. Diese Methode ähnelt Environment.GetEnvironmentVariable(String), doch löst sie eine Ausnahme aus, wenn die von name angegebene Umgebungsvariable nicht vorhanden ist.
Beispiel
In diesem Beispiel wird die My.Application.GetEnvironmentVariable-Methode verwendet, um den Wert der PATH-Umgebungsvariablen abzurufen und ggf. anzuzeigen. Andernfalls wird eine Meldung angezeigt, die angibt, dass die PATH-Umgebungsvariable nicht vorhanden ist.
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
Anforderungen
Namespace: Microsoft.VisualBasic.ApplicationServices
Klasse: WindowsFormsApplicationBase, ApplicationBase
Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)
Verfügbarkeit nach Projekttyp
Projekttyp |
Verfügbar |
---|---|
Windows-Anwendung |
Ja |
Klassenbibliothek |
Ja |
Konsolenanwendung |
Ja |
Windows-Steuerelementbibliothek |
Ja |
Web-Steuerelementbibliothek |
Nein |
Windows-Dienst |
Ja |
Website |
Nein |
Berechtigungen
Es sind keine Berechtigungen erforderlich.