הערה
הפונקציה, פעולת השירות, האובייקט או המאפיין המתוארים בנושא זה אינם זמינים אם שירות הביטויים של Microsoft Jet פועל במצב ארגז חול (Sandbox) שמונע הערכה של ביטויים שעלולים להיות לא בטוחים. לקבלת מידע נוסף על מצב ארגז חול, חפש את "מצב ארגז חול" בעזרה.
החזרת המחרוזת המשויכת למשתנה סביבה של מערכת הפעלה. לא זמין ב- Macintosh
תחביר
Environ( { envstring | number } )
תחביר הפונקציה Environ מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| מחרוזת envstring | אופציונלי. ביטוי מחרוזת המכיל את השם של משתנה סביבה. |
| מספר | אופציונלי. ביטוי מספרי התואם בסדר המספרי של מחרוזת הסביבה בטבלת מחרוזות הסביבה. הארגומנט number יכול להיות כל ביטוי מספרי, אך הוא מעוגל למספר שלם לפני הערכתו. |
הערות
אם לא ניתן למצוא envstring בטבלת מחרוזות הסביבה, מוחזרת מחרוזת באורך אפס (""). אחרת, הפונקציה Environ מחזירה את הטקסט שהוקצה ל envstring שצוין; לדוגמה, הטקסט הבא אחרי סימן השוויון (=) בטבלת מחרוזות הסביבה עבור משתנה סביבה זה.
אם תציין מספר, המחרוזת הכובשת את המיקום המספרי בטבלת מחרוזות הסביבה מוחזרת. במקרה זה, Environ מחזיר את כל הטקסט, כולל envstring. אם אין מחרוזת סביבה במיקום שצוין, הפונקציה Environ מחזירה מחרוזת באורך אפס.
דוגמה
הערה
הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.
דוגמה זו משתמשת בפונקציה Environ כדי לספק את מספר הערך ואת אורך PATH המשפט מטבלת מחרוזות הסביבה. לא זמין ב- Macintosh.
Dim EnvString, Indx, Msg, PathLen ' Declare variables.
Indx = 1 ' Initialize index to 1.
Do
' Get environment variable.
EnvString = Environ(Indx)
' Check PATH entry.
If Left(EnvString, 5) = "PATH=" Then
' Get length.
PathLen = Len(Environ("PATH"))
Msg = "PATH entry = " & Indx & " and length = " _
& PathLen
Exit Do
Else
' Not PATH entry, so increment.
Indx = Indx + 1
End If
Loop Until EnvString = ""
If PathLen > 0 Then
' Display message.
MsgBox Msg
Else
MsgBox "No PATH environment variable exists."
End If