Interaction.Environ Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Gibt die zu einer Betriebssystem-Umgebungsvariablen gehörige Zeichenfolge zurück.

Überlädt

Environ(String)	Gibt die zu einer Betriebssystem-Umgebungsvariablen gehörige Zeichenfolge zurück.
Environ(Int32)	Gibt die zu einer Betriebssystem-Umgebungsvariablen gehörige Zeichenfolge zurück.

Environ(String)

Quelle:

Interaction.vb

Gibt die zu einer Betriebssystem-Umgebungsvariablen gehörige Zeichenfolge zurück.

public:
 static System::String ^ Environ(System::String ^ Expression);

public static string Environ (string? Expression);

static member Environ : string -> string

Public Function Environ (Expression As String) As String

Parameter

Expression

String

Erforderlich. Ausdruck, der entweder eine Zeichenfolge mit dem Namen einer Umgebungsvariablen oder eine ganze Zahl auswertet, die der numerischen Position einer Umgebungszeichenfolge in der Tabelle mit Umgebungszeichenfolgen entspricht.

Gibt zurück

String

Die Zeichenfolge, die einer Betriebssystem-Umgebungsvariable zugeordnet ist.

Ausnahmen

ArgumentException

Expression fehlt.

Beispiele

In diesem Beispiel wird die Environ -Funktion verwendet, um die Eintragsnummer und die Länge der PATH Anweisung aus der Umgebungszeichenfolgentabelle anzugeben.

Sub tenv()
    Dim envString As String
    Dim found As Boolean = False
    Dim index As Integer = 1
    Dim pathLength As Integer
    Dim message As String

    envString = Environ(index)
    While Not found And (envString <> "")
        If (envString.Substring(0, 5) = "Path=") Then
            found = True
        Else
            index += 1
            envString = Environ(index)
        End If
    End While

    If found Then
        pathLength = Environ("PATH").Length
        message = "PATH entry = " & index & " and length = " & pathLength
    Else
        message = "No PATH environment variable exists."
    End If

    MsgBox(message)
End Sub

Hinweise

Wenn Expression eine Zeichenfolge enthält, gibt die Environ Funktion den Text zurück, der der angegebenen Umgebungszeichenfolge zugewiesen ist, d. h. den Text, der dem Gleichheitszeichen (=) in der Umgebungszeichenfolgentabelle für diese Umgebungsvariable folgt. Wenn die Zeichenfolge in Expression in in der Umgebungszeichenfolgentabelle nicht gefunden werden kann, wird eine Zeichenfolge der Länge null ("") zurückgegeben.

Wenn Expression eine ganze Zahl enthält, wird die Zeichenfolge zurückgegeben, die diese numerische Position in der Umgebungszeichenfolgentabelle einnimmt. In diesem Fall Environ gibt den gesamten Text zurück, einschließlich des Namens der Umgebungsvariablen. Wenn an der angegebenen Position keine Umgebungszeichenfolge vorhanden ist, Environ wird eine Zeichenfolge mit der Länge null zurückgegeben.

Wichtig

Die Environ Funktion benötigt eine Umgebungsberechtigung, die sich auf die Ausführung in teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter SecurityPermission und Codezugriffsberechtigungen.

Weitere Informationen

• ArgumentException
• Elemente der Visual Basic-Run-Time-Bibliothek

Environ(Int32)

Quelle:

Interaction.vb

Gibt die zu einer Betriebssystem-Umgebungsvariablen gehörige Zeichenfolge zurück.

public:
 static System::String ^ Environ(int Expression);

public static string Environ (int Expression);

static member Environ : int -> string

Public Function Environ (Expression As Integer) As String

Parameter

Expression

Int32

Erforderlich. Ausdruck, der entweder eine Zeichenfolge mit dem Namen einer Umgebungsvariablen oder eine ganze Zahl auswertet, die der numerischen Position einer Umgebungszeichenfolge in der Tabelle mit Umgebungszeichenfolgen entspricht.

Gibt zurück

String

Die Zeichenfolge, die einer Betriebssystem-Umgebungsvariable zugeordnet ist.

Ausnahmen

ArgumentException

Expression fehlt.

Beispiele

In diesem Beispiel wird die Environ -Funktion verwendet, um die Eintragsnummer und die Länge der PATH Anweisung aus der Umgebungszeichenfolgentabelle anzugeben.

Sub tenv()
    Dim envString As String
    Dim found As Boolean = False
    Dim index As Integer = 1
    Dim pathLength As Integer
    Dim message As String

    envString = Environ(index)
    While Not found And (envString <> "")
        If (envString.Substring(0, 5) = "Path=") Then
            found = True
        Else
            index += 1
            envString = Environ(index)
        End If
    End While

    If found Then
        pathLength = Environ("PATH").Length
        message = "PATH entry = " & index & " and length = " & pathLength
    Else
        message = "No PATH environment variable exists."
    End If

    MsgBox(message)
End Sub

Hinweise

Wenn Expression eine Zeichenfolge enthält, gibt die Environ Funktion den Text zurück, der der angegebenen Umgebungszeichenfolge zugewiesen ist, d. h. den Text, der dem Gleichheitszeichen (=) in der Umgebungszeichenfolgentabelle für diese Umgebungsvariable folgt. Wenn die Zeichenfolge in Expression in in der Umgebungszeichenfolgentabelle nicht gefunden werden kann, wird eine Zeichenfolge der Länge null ("") zurückgegeben.

Wenn Expression eine ganze Zahl enthält, wird die Zeichenfolge zurückgegeben, die diese numerische Position in der Umgebungszeichenfolgentabelle einnimmt. In diesem Fall Environ gibt den gesamten Text zurück, einschließlich des Namens der Umgebungsvariablen. Wenn an der angegebenen Position keine Umgebungszeichenfolge vorhanden ist, Environ wird eine Zeichenfolge mit der Länge null zurückgegeben.

Wichtig

Die Environ Funktion benötigt eine Umgebungsberechtigung, die sich auf die Ausführung in teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter SecurityPermission und Codezugriffsberechtigungen.

Weitere Informationen

• ArgumentException
• Elemente der Visual Basic-Run-Time-Bibliothek