setlocal

Elindítja a környezeti változók honosítását egy kötegfájlban. A honosítás addig folytatódik, amíg el nem éri a megfelelő endlocal parancsot, vagy el nem éri a kötegfájl végét.

Szinopszis

setlocal [enableextensions | disableextensions] [enabledelayedexpansion | disabledelayedexpansion]

Paraméterek

Paraméter	Leírás
Bővítmények engedélyezése	Engedélyezi a parancsbővítményeket, amíg a megfelelő endlocal parancs nem található, függetlenül attól, hogy a setlocal parancs futtatása előtt milyen beállítás történt.
letilta a kiterjesztéseket	Letiltja a parancsbővítményeket, amíg a megfelelő endlocal parancs nem ütközik, függetlenül attól, hogy a setlocal parancs futtatása előtt milyen beállítás történt.
késleltetett bővítés engedélyezése	Engedélyezi a késleltetett környezeti változóbővítést mindaddig, amíg az egyező endlocal parancs nem ütközik, függetlenül attól, hogy a beállítás a setlocal parancs futtatása előtt történt- e.
letiltott késleltetett bővítés	Letiltja a késleltetett környezeti változóbővítést, amíg a megfelelő endlocal parancs nem ütközik, függetlenül attól, hogy a setlocal parancs futtatása előtt milyen beállítás történt.
/?	Súgó megjelenítése a parancssorban.

Megjegyzések

• Ha szkripten vagy kötegfájlon kívül setlocal használ, annak nincs hatása.

• A setlocal használatával módosíthatja a környezeti változókat kötegelt fájl futtatásakor. A setlocal futtatása után végrehajtott környezeti módosítások helyiek a kötegfájlban. A Cmd.exe program visszaállítja a korábbi beállításokat, amikor endlocal paranccsal találkozik, vagy eléri a kötegfájl végét.

• Egy kötegprogramban több setlocal vagy endlocal parancsot is használhat (azaz beágyazott parancsokat).

• A setlocal parancs beállítja az ERRORLEVEL változót. Ha {enableextensions | disableextensions} vagy {enabledelayedexpansion | disabledelayedexpansion} értékre van állítva, az ERRORLEVEL változó értéke 0 (nulla). Ellenkező esetben 1 van beállítva. Ezeket az információkat kötegelt szkriptekben használhatja annak megállapítására, hogy a bővítmények elérhetők-e, ahogyan az alábbi példában látható:

  verify other 2>nul
  setlocal enableextensions
  if errorlevel 1 echo Unable to enable extensions
  

  Mivel parancsmag nem állítja be az ERRORLEVEL változót a parancsbővítmények letiltásakor, a ellenőrzi, hogy parancs érvénytelen argumentummal inicializálja az ERRORLEVEL változót érvénytelen értékre. Ha a setlocal parancsot {enableextensions | disableextensions} vagy {enabledelayedexpansion | disabledelayedexpansion} argumentummal használja, és nem állítja be az ERRORLEVEL változót 1 , a parancsbővítmények nem érhetők el.

Példák

A környezeti változók kötegelt fájlban való honosításához kövesse az alábbi példaszkriptet:

rem *******Begin Comment**************
rem This program starts the superapp batch program on the network,
rem directs the output to a file, and displays the file
rem in Notepad.
rem *******End Comment**************
@echo off
setlocal
path=g:\programs\superapp;%path%
call superapp>c:\superapp.out
endlocal
start notepad c:\superapp.out

Kapcsolódó hivatkozások

• Command-Line szintaxiskulcs