Interaction.Environ Methode

Definitie

Naamruimte:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Retourneert de tekenreeks die is gekoppeld aan een omgevingsvariabele van het besturingssysteem.

Overloads

Name Description
Environ(String)

Retourneert de tekenreeks die is gekoppeld aan een omgevingsvariabele van het besturingssysteem.
Environ(Int32)

Retourneert de tekenreeks die is gekoppeld aan een omgevingsvariabele van het besturingssysteem.

Environ(String)

Retourneert de tekenreeks die is gekoppeld aan een omgevingsvariabele van het besturingssysteem.

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

Parameters

Expression
String

Required. Expressie waarmee een tekenreeks wordt geëvalueerd die de naam van een omgevingsvariabele bevat of een geheel getal dat overeenkomt met de numerieke volgorde van een omgevingsreeks in de tabel met omgevingsreeksen.

Retouren

String

De tekenreeks die is gekoppeld aan een omgevingsvariabele van het besturingssysteem.

Uitzonderingen

ArgumentException

Expression ontbreekt.

Voorbeelden

In dit voorbeeld wordt de Environ functie gebruikt om het invoernummer en de lengte van de PATH instructie op te geven uit de tabel met omgevingsreeksen.

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

Opmerkingen

Als Expression deze een tekenreeks bevat, retourneert de Environ functie de tekst die is toegewezen aan de opgegeven omgevingsreeks. Dat wil gezegd, de tekst na het gelijkteken (=) in de tabel met omgevingsreeksen voor die omgevingsvariabele. Als de tekenreeks Expression niet kan worden gevonden in de tabel met omgevingstekenreeksen, wordt een tekenreeks met lengte nul ("") geretourneerd.

Als Expression dit een geheel getal bevat, wordt de tekenreeks die die numerieke positie in de tabel met omgevingsreeksen bezette, geretourneerd. In dit geval Environ wordt alle tekst geretourneerd, inclusief de naam van de omgevingsvariabele. Als er geen omgevingstekenreeks op de opgegeven positie staat, Environ wordt een tekenreeks met lengte nul geretourneerd.

Important

De Environ functie vereist omgevingsmachtigingen, die van invloed kunnen zijn op de uitvoering ervan in gedeeltelijke vertrouwenssituaties. Zie en Machtigingen voor codetoegang voor meer informatieSecurityPermission.

Zie ook

Van toepassing op

Environ(Int32)

Retourneert de tekenreeks die is gekoppeld aan een omgevingsvariabele van het besturingssysteem.

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

Parameters

Expression
Int32

Required. Expressie waarmee een tekenreeks wordt geëvalueerd die de naam van een omgevingsvariabele bevat of een geheel getal dat overeenkomt met de numerieke volgorde van een omgevingsreeks in de tabel met omgevingsreeksen.

Retouren

String

De tekenreeks die is gekoppeld aan een omgevingsvariabele van het besturingssysteem.

Uitzonderingen

ArgumentException

Expression ontbreekt.

Voorbeelden

In dit voorbeeld wordt de Environ functie gebruikt om het invoernummer en de lengte van de PATH instructie op te geven uit de tabel met omgevingsreeksen.

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

Opmerkingen

Als Expression deze een tekenreeks bevat, retourneert de Environ functie de tekst die is toegewezen aan de opgegeven omgevingsreeks. Dat wil gezegd, de tekst na het gelijkteken (=) in de tabel met omgevingsreeksen voor die omgevingsvariabele. Als de tekenreeks Expression niet kan worden gevonden in de tabel met omgevingstekenreeksen, wordt een tekenreeks met lengte nul ("") geretourneerd.

Als Expression dit een geheel getal bevat, wordt de tekenreeks die die numerieke positie in de tabel met omgevingsreeksen bezette, geretourneerd. In dit geval Environ wordt alle tekst geretourneerd, inclusief de naam van de omgevingsvariabele. Als er geen omgevingstekenreeks op de opgegeven positie staat, Environ wordt een tekenreeks met lengte nul geretourneerd.

Important

De Environ functie vereist omgevingsmachtigingen, die van invloed kunnen zijn op de uitvoering ervan in gedeeltelijke vertrouwenssituaties. Zie en Machtigingen voor codetoegang voor meer informatieSecurityPermission.

Zie ook

Van toepassing op