Funzione Environ

Aggiornamento: novembre 2007

Restituisce la stringa associata alla variabile di ambiente del sistema operativo.

Overloads Function Environ(ByVal Expression As Integer) As String
' -or-
Overloads Function Environ(ByVal Expression As String) As String

Parametri

• Expression
  Obbligatorio. Espressione che restituisce una stringa con il nome di una variabile di ambiente oppure un valore integer corrispondente alla posizione numerica di una stringa nella tabella delle stringhe di ambiente.

Eccezioni

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Se Expression contiene una stringa, la funzione Environ restituirà il testo assegnato alla stringa di ambiente specificata, ossia il testo che segue il segno di uguale (=) nella tabella delle stringhe di ambiente per la variabile di ambiente in questione. Se la stringa inclusa in Expression non viene trovata nella tabella delle stringhe di ambiente, verrà restituita una stringa di lunghezza zero ("").

Se Expression contiene un valore integer, verrà restituita la stringa che occupa la corrispondente posizione numerica nella tabella delle stringhe di ambiente. In tal caso la funzione Environ restituirà l'intero testo, compreso il nome della variabile di ambiente. Se nella posizione specificata non viene individuata alcuna stringa di ambiente, la funzione Environ restituirà una stringa di lunghezza zero.

Nota sulla sicurezza:
La funzione Environ richiede l'autorizzazione di accesso all'ambiente, che può influenzarne l'esecuzione in situazioni di attendibilità parziale. Per ulteriori informazioni, vedere SecurityPermission e Permessi di accesso al codice.

Esempio

Nell'esempio riportato di seguito la funzione Environ viene utilizzata per recuperare il numero di voce e la lunghezza dell'istruzione PATH dalla tabella delle stringhe di ambiente.

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

Note per gli sviluppatori di applicazioni per Smart Device

Questa funzione non è supportata.

Requisiti

Spazio dei nomi: Microsoft.VisualBasic

**Modulo:**Interaction

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Vedere anche

Riferimenti

Membri delle librerie di runtime di Visual Basic

ArgumentException