ApplicationBase.GetEnvironmentVariable(String) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.ApplicationServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt den Wert der angegebenen Umgebungsvariablen zurück.

public:
 System::String ^ GetEnvironmentVariable(System::String ^ name);

public string GetEnvironmentVariable (string name);

member this.GetEnvironmentVariable : string -> string

Public Function GetEnvironmentVariable (name As String) As String

Parameter

name: String

Ein String, der den Namen der Umgebungsvariablen enthält.

Gibt zurück

String

Ein String, der den Wert der Umgebungsvariablen mit dem Namen name enthält.

Ausnahmen

ArgumentNullException

name ist Nothing.

ArgumentException

Die von name angegebene Umgebungsvariable ist nicht vorhanden.

SecurityException

Der aufrufende Code verfügt über keine EnvironmentPermission mit Read-Zugriff.

Beispiele

In diesem Beispiel wird die My.Application.GetEnvironmentVariable -Methode verwendet, um den Wert der PATH-Umgebungsvariablen abzurufen und anzuzeigen, sofern verfügbar. 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

Hinweise

Die My.Application.GetEnvironmentVariable -Methode gibt die Umgebungsvariable mit dem Namen namezurück. Diese Methode ähnelt Environment.GetEnvironmentVariable(String), mit der Ausnahme, dass diese Methode eine Ausnahme auslöst, wenn die durch name angegebene Umgebungsvariable nicht vorhanden ist.

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows Forms-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows Forms-Steuerelementbibliothek	Ja
Websteuerelementbibliothek	Nein
Windows-Dienst	Ja
Website	Nein

Gilt für:

Freigeben über