Interaction.Environ Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.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 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)

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 Anweisung aus der PATH Umgebungszeichenfolgentabelle bereitzustellen.

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 enthalten ist, gibt die Environ Funktion den Text zurück, der der angegebenen Umgebungszeichenfolge zugewiesen ist - das heißt, der Text folgt dem Gleichheitszeichen (=) in der Umgebungszeichenfolgentabelle für diese Umgebungsvariable. Wenn die Zeichenfolge Expression in der Umgebungszeichenfolgentabelle nicht gefunden werden kann, wird eine Nulllängenzeichenfolge ("") zurückgegeben.

Wenn Expression eine ganze Zahl enthalten ist, wird die Zeichenfolge, die diese numerische Position in der Umgebungszeichenfolgentabelle enthält, zurückgegeben. Gibt in diesem Fall Environ alle Text zurück, einschließlich des Namens der Umgebungsvariable. Wenn keine Umgebungszeichenfolge in der angegebenen Position vorhanden ist, Environ gibt eine Nulllängenzeichenfolge zurück.

Wichtig

Die Environ Funktion erfordert Die Umgebungsberechtigung, die sich auf die Ausführung in teilvertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter SecurityPermission und Codezugriffsberechtigungen.

Siehe auch

Gilt für:

Environ(Int32)

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

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 bereitzustellen.

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 enthalten ist, gibt die Environ Funktion den Text zurück, der der angegebenen Umgebungszeichenfolge zugewiesen ist . Das heißt, der Text folgt dem Gleichheitszeichen (=) in der Umgebungszeichenfolgentabelle für diese Umgebungsvariable. Wenn die Zeichenfolge Expression in der Umgebungszeichenfolgentabelle nicht gefunden werden kann, wird eine leere Zeichenfolge ("") zurückgegeben.

Wenn Expression eine ganze Zahl enthalten ist, wird die Zeichenfolge, die diese numerische Position in der Umgebungszeichenfolgentabelle belegt, zurückgegeben. In diesem Fall Environ wird der gesamte Text zurückgegeben, einschließlich des Namens der Umgebungsvariable. Wenn keine Umgebungszeichenfolge an der angegebenen Position vorhanden ist, Environ wird eine leere Zeichenfolge zurückgegeben.

Wichtig

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

Siehe auch

Gilt für: