Interaction.Environ Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Zwraca ciąg skojarzony ze zmienną środowiskową systemu operacyjnego.

Przeciążenia

Environ(String)	Zwraca ciąg skojarzony ze zmienną środowiskową systemu operacyjnego.
Environ(Int32)	Zwraca ciąg skojarzony ze zmienną środowiskową systemu operacyjnego.

Environ(String)

Źródło:

Interaction.vb

Zwraca ciąg skojarzony ze zmienną środowiskową systemu operacyjnego.

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

Parametry

Expression

String

Wymagane. Wyrażenie, które oblicza ciąg zawierający nazwę zmiennej środowiskowej lub liczbę całkowitą odpowiadającą kolejności liczbowej ciągu środowiskowego w tabeli ciągów środowiskowych.

Zwraca

String

Ciąg skojarzony ze zmienną środowiskową systemu operacyjnego.

Wyjątki

ArgumentException

Expression brak.

Przykłady

W tym przykładzie użyto Environ funkcji w celu podania numeru wpisu i długości PATH instrukcji z tabeli ciągów środowiskowych.

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

Uwagi

Jeśli Expression zawiera ciąg, Environ funkcja zwraca tekst przypisany do określonego ciągu środowiskowego — oznacza to, że tekst podążający za znakiem równości (=) w tabeli ciągów środowiskowych dla tej zmiennej środowiskowej. Jeśli nie można odnaleźć ciągu w Expression tabeli environment-string, zwracany jest ciąg o zerowej długości ("").

Jeśli Expression zawiera liczbę całkowitą, zwracany jest ciąg zajmujący to położenie liczbowe w tabeli ciągów środowiskowych. W takim przypadku zwraca cały tekst, Environ w tym nazwę zmiennej środowiskowej. Jeśli w określonej pozycji nie ma ciągu środowiskowego, Environ zwraca ciąg o zerowej długości.

Ważne

Funkcja Environ wymaga uprawnień środowiska, co może mieć wpływ na jego wykonywanie w sytuacjach częściowego zaufania. Aby uzyskać więcej informacji, zobacz SecurityPermission i Uprawnienia dostępu do kodu.

Zobacz też

• ArgumentException
• Elementy członkowskie biblioteki Run-Time Visual Basic

Environ(Int32)

Źródło:

Interaction.vb

Zwraca ciąg skojarzony ze zmienną środowiskową systemu operacyjnego.

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

Parametry

Expression

Int32

Wymagane. Wyrażenie, które oblicza ciąg zawierający nazwę zmiennej środowiskowej lub liczbę całkowitą odpowiadającą kolejności liczbowej ciągu środowiskowego w tabeli ciągów środowiskowych.

Zwraca

String

Ciąg skojarzony ze zmienną środowiskową systemu operacyjnego.

Wyjątki

ArgumentException

Expression brak.

Przykłady

W tym przykładzie użyto Environ funkcji w celu podania numeru wpisu i długości PATH instrukcji z tabeli ciągów środowiskowych.

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

Uwagi

Jeśli Expression zawiera ciąg, Environ funkcja zwraca tekst przypisany do określonego ciągu środowiskowego — oznacza to, że tekst podążający za znakiem równości (=) w tabeli ciągów środowiskowych dla tej zmiennej środowiskowej. Jeśli nie można odnaleźć ciągu w Expression tabeli environment-string, zwracany jest ciąg o zerowej długości ("").

Jeśli Expression zawiera liczbę całkowitą, zwracany jest ciąg zajmujący to położenie liczbowe w tabeli ciągów środowiskowych. W takim przypadku zwraca cały tekst, Environ w tym nazwę zmiennej środowiskowej. Jeśli w określonej pozycji nie ma ciągu środowiskowego, Environ zwraca ciąg o zerowej długości.

Ważne

Funkcja Environ wymaga uprawnień środowiska, co może mieć wpływ na jego wykonywanie w sytuacjach częściowego zaufania. Aby uzyskać więcej informacji, zobacz SecurityPermission i Uprawnienia dostępu do kodu.

Zobacz też

• ArgumentException
• Elementy członkowskie biblioteki Run-Time Visual Basic