Interaction.Environ Método

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.dll

Devuelve la cadena asociada a una variable de entorno del sistema operativo.

Sobrecargas

Nombre Description
Environ(String)

Devuelve la cadena asociada a una variable de entorno del sistema operativo.
Environ(Int32)

Devuelve la cadena asociada a una variable de entorno del sistema operativo.

Environ(String)

Devuelve la cadena asociada a una variable de entorno del sistema operativo.

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

Parámetros

Expression
String

Required. Expresión que evalúa una cadena que contiene el nombre de una variable de entorno o un entero correspondiente al orden numérico de una cadena de entorno en la tabla environment-string.

Devoluciones

String

Cadena asociada a una variable de entorno del sistema operativo.

Excepciones

ArgumentException

Expression falta.

Ejemplos

En este ejemplo se usa la Environ función para proporcionar el número de entrada y la longitud de la instrucción de la PATH tabla de cadena de entorno.

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

Comentarios

Si Expression contiene una cadena, la Environ función devuelve el texto asignado a la cadena de entorno especificada; es decir, el texto que sigue al signo igual (=) de la tabla de cadena de entorno para esa variable de entorno. Si la cadena de no se encuentra en Expression la tabla environment-string, se devuelve una cadena de longitud cero ("").

Si Expression contiene un entero, se devuelve la cadena que ocupa esa posición numérica en la tabla de cadena de entorno. En este caso, Environ devuelve todo el texto, incluido el nombre de la variable de entorno. Si no hay ninguna cadena de entorno en la posición especificada, Environ devuelve una cadena de longitud cero.

Importante

La Environ función requiere permiso de entorno, que podría afectar a su ejecución en situaciones de confianza parcial. Para obtener más información, consulte SecurityPermission y Permisos de acceso de código.

Consulte también

Se aplica a

Environ(Int32)

Devuelve la cadena asociada a una variable de entorno del sistema operativo.

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

Parámetros

Expression
Int32

Required. Expresión que evalúa una cadena que contiene el nombre de una variable de entorno o un entero correspondiente al orden numérico de una cadena de entorno en la tabla environment-string.

Devoluciones

String

Cadena asociada a una variable de entorno del sistema operativo.

Excepciones

ArgumentException

Expression falta.

Ejemplos

En este ejemplo se usa la Environ función para proporcionar el número de entrada y la longitud de la instrucción de la PATH tabla de cadena de entorno.

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

Comentarios

Si Expression contiene una cadena, la Environ función devuelve el texto asignado a la cadena de entorno especificada; es decir, el texto que sigue al signo igual (=) de la tabla de cadena de entorno para esa variable de entorno. Si la cadena de no se encuentra en Expression la tabla environment-string, se devuelve una cadena de longitud cero ("").

Si Expression contiene un entero, se devuelve la cadena que ocupa esa posición numérica en la tabla de cadena de entorno. En este caso, Environ devuelve todo el texto, incluido el nombre de la variable de entorno. Si no hay ninguna cadena de entorno en la posición especificada, Environ devuelve una cadena de longitud cero.

Importante

La Environ función requiere permiso de entorno, que podría afectar a su ejecución en situaciones de confianza parcial. Para obtener más información, consulte SecurityPermission y Permisos de acceso de código.

Consulte también

Se aplica a