Freigeben über

Interaction.Environ Methode

  • Referenz

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.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
Quelle:
Interaction.vb
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);
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. der 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 leere Zeichenfolge ("") 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 gibt den gesamten Text zurück, Environ einschließlich des Namens der Umgebungsvariablen. Wenn an der angegebenen Position keine Umgebungszeichenfolge vorhanden ist, Environ wird eine Zeichenfolge der Länge Null zurückgegeben.

Wichtig

Die Environ Funktion erfordert 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

Gilt für:

Environ(Int32)

Quelle:
Interaction.vb
Quelle:
Interaction.vb
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. der 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 leere Zeichenfolge ("") 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 gibt den gesamten Text zurück, Environ einschließlich des Namens der Umgebungsvariablen. Wenn an der angegebenen Position keine Umgebungszeichenfolge vorhanden ist, Environ wird eine Zeichenfolge der Länge Null zurückgegeben.

Wichtig

Die Environ Funktion erfordert 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

Gilt für: