Interaction.Environ Метод

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Возвращает строку, связанную с переменной среды операционной системы.

Перегрузки

Environ(String)	Возвращает строку, связанную с переменной среды операционной системы.
Environ(Int32)	Возвращает строку, связанную с переменной среды операционной системы.

Environ(String)

Исходный код:

Interaction.vb

Возвращает строку, связанную с переменной среды операционной системы.

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

Параметры

Expression

String

Обязательный. Значение, которое вычисляется либо как строка, содержащая имя переменной среды, либо как целое число, соответствующее порядковому номеру строки в таблице строк среды.

Возвращаемое значение

String

Строка, связанная с переменной среды операционной системы.

Исключения

ArgumentException

Expression отсутствует.

Примеры

В этом примере функция используется Environ для предоставления начального номера и длины инструкции PATH из таблицы строк среды.

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

Комментарии

Если Expression содержит строку, функция возвращает текст, Environ назначенный указанной строке среды, то есть текст после знака равенства (=) в таблице строк среды для этой переменной среды. Если строка в Expression не найдена в таблице строк среды, возвращается строка нулевой длины ("").

Если Expression содержит целое число, возвращается строка, занимающая эту числовую позицию в таблице строк среды. В этом случае Environ возвращает весь текст, включая имя переменной среды. Если в указанной позиции нет строки среды, Environ возвращается строка нулевой длины.

Важно!

Функции Environ требуется разрешение среды, что может повлиять на ее выполнение в ситуациях с частичным доверием. Дополнительные сведения см. в разделах SecurityPermission и Разрешения на доступ к коду.

См. также раздел

• ArgumentException
• Элементы библиотеки Run-Time Visual Basic

Environ(Int32)

Исходный код:

Interaction.vb

Возвращает строку, связанную с переменной среды операционной системы.

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

Параметры

Expression

Int32

Обязательный. Значение, которое вычисляется либо как строка, содержащая имя переменной среды, либо как целое число, соответствующее порядковому номеру строки в таблице строк среды.

Возвращаемое значение

String

Строка, связанная с переменной среды операционной системы.

Исключения

ArgumentException

Expression отсутствует.

Примеры

В этом примере функция используется Environ для предоставления начального номера и длины инструкции PATH из таблицы строк среды.

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

Комментарии

Если Expression содержит строку, функция возвращает текст, Environ назначенный указанной строке среды, то есть текст после знака равенства (=) в таблице строк среды для этой переменной среды. Если строка в Expression не найдена в таблице строк среды, возвращается строка нулевой длины ("").

Если Expression содержит целое число, возвращается строка, занимающая эту числовую позицию в таблице строк среды. В этом случае Environ возвращает весь текст, включая имя переменной среды. Если в указанной позиции нет строки среды, Environ возвращается строка нулевой длины.

Важно!

Функции Environ требуется разрешение среды, что может повлиять на ее выполнение в ситуациях с частичным доверием. Дополнительные сведения см. в разделах SecurityPermission и Разрешения на доступ к коду.

См. также раздел

• ArgumentException
• Элементы библиотеки Run-Time Visual Basic