about_Try_Catch_Finally
Rövid leírás
Ismerteti, hogyan használható a try, catchés finally blokkok a megszüntetési hibák kezelésére.
Hosszú leírás
A tryparancsprogramokban catcha , és finally a blokkok használatával válaszolhat vagy kezelhet megszakítási hibákat. Az Trap utasítás a szkriptek végződési hibáinak kezelésére is használható. További információ: about_Trap.
A megszüntetési hiba leállítja az utasítás futtatását. Ha a PowerShell valamilyen módon nem kezeli a megszüntetési hibát, a PowerShell az aktuális folyamat használatával is leállítja a függvény vagy szkript futtatását. Más nyelvekben, például a C#-ban a megszüntetési hibákat kivételeknek nevezzük.
try A blokk használatával definiálhatja egy szkript azon szakaszát, amelyben a PowerShell figyeli a hibákat. Ha hiba történik a try blokkon belül, a rendszer először menti a hibát az $Error automatikus változóba. A PowerShell ezután megkeres egy blokkot catch a hiba kezeléséhez. Ha az try utasítás nem rendelkezik egyező catch blokktal, a PowerShell továbbra is keres egy megfelelő catch blokkot vagy Trap utasítást a szülő hatókörökben. catch Ha a blokk befejeződött, vagy ha nem található megfelelő catch blokk vagy Trap utasítás, a finally blokk lefut. Ha a hiba nem kezelhető, a hiba a hibastreambe lesz írva.
A catch blokkok tartalmazhatnak parancsokat a hiba nyomon követéséhez vagy a szkript várt folyamatának helyreállításához. A catch blokkok meg tudják adni, hogy mely hibatípusokat kapja meg. Az try utasítások több catch blokkot is tartalmazhatnak különböző típusú hibákhoz.
A finally blokkok olyan erőforrások felszabadítására használhatók, amelyekre már nincs szüksége a szkriptnek.
try, catchés hasonlít a tryC# programozási nyelvben használt , catchés finally kulcsszavakra.finally
Syntax
Az try utasítás tartalmaz egy blokkot try , nulla vagy több catch blokkot, valamint nulla vagy egy finally blokkot. Az try utasításnak legalább egy catch blokktal vagy blokktal finally kell rendelkeznie.
Az alábbiakban a blokk szintaxisa try látható:
try {<statement list>}
A try kulcsszót egy kapcsos zárójelben lévő utasításlista követi. Ha az utasításlistában szereplő utasítások futtatása közben megszűnő hiba történik, a szkript átadja a hibaobjektumot a blokkból egy try megfelelő catch blokkba.
Az alábbiakban a blokk szintaxisa catch látható:
catch [[<error type>][',' <error type>]*] {<statement list>}
A hibatípusok szögletes zárójelekben jelennek meg. A legkülső zárójelek azt jelzik, hogy az elem nem kötelező.
A catch kulcsszót a hibatípus-specifikációk opcionális listája és egy utasításlista követi. Ha a blokkban megszűnő hiba történik, a PowerShell megkeresi a try megfelelő catch blokkot. Ha talál ilyet, a rendszer végrehajtja a catch blokkban lévő utasításokat.
A catch blokk megadhat egy vagy több hibatípust. A hibatípus egy Microsoft .NET-keretrendszer kivétel, vagy egy .NET-keretrendszer kivételből származó kivétel. A catch blokkok a megadott .NET-keretrendszer kivételosztály vagy a megadott osztályból származó bármely osztály hibáit kezelik.
Ha egy catch blokk hibatípust ad meg, az a catch blokk kezeli az adott hibatípust. Ha egy catch blokk nem ad meg hibatípust, az a catch blokk kezeli a try blokkban előforduló hibákat. Egy try utasítás több catch blokkot is tartalmazhat a különböző megadott hibatípusokhoz.
Az alábbiakban a blokk szintaxisa finally látható:
finally {<statement list>}
A finally kulcsszót egy utasításlista követi, amely a szkript minden futtatásakor fut, még akkor is, ha az try utasítás hiba nélkül futott, vagy egy utasítás hibát észlelt catch .
Vegye figyelembe, hogy a CTRL C billentyű lenyomásával +leállítja a folyamatot. A folyamatnak küldött objektumok nem jelennek meg kimenetként. Ezért ha egy megjelenítendő utasítást (például "A blokk futtatása befejeződött") tartalmaz, akkor a CTRL C billentyűkombináció+lenyomása után sem jelenik meg, még akkor sem, ha a finally blokk futott.
Hibák észlelése
Az alábbi példaszkript egy try blokkot tartalmazó blokkot catch mutat be:
try { NonsenseString }
catch { "An error occurred." }
A catch kulcsszónak azonnal követnie kell a try blokkot vagy egy másik catch blokkot.
A PowerShell nem ismeri fel a "NonsenseString" parancsmagot vagy egyéb elemet. A szkript futtatása a következő eredményt adja vissza:
An error occurred.
Amikor a szkript "Nonszenszstring" hibába ütközik, az végződési hibát okoz. A catch blokk úgy kezeli a hibát, hogy a blokkon belül futtatja az utasításlistát.
Több fogási utasítás használata
Az try utasítások tetszőleges számú blokkot tartalmazhatnak catch . A következő szkript például letölt MyDoc.docegy try blokkot, amely két catch blokkot tartalmaz:
try {
$wc = new-object System.Net.WebClient
$wc.DownloadFile("http://www.contoso.com/MyDoc.doc","c:\temp\MyDoc.doc")
}
catch [System.Net.WebException],[System.IO.IOException] {
"Unable to download MyDoc.doc from http://www.contoso.com."
}
catch {
"An error occurred that could not be resolved."
}
Az első catch blokk a System.Net.WebException és a System.IO.IOException típus hibáit kezeli. A második catch blokk nem ad meg hibatípust. A második catch blokk kezeli az esetlegesen előforduló egyéb megszűnési hibákat.
A PowerShell öröklés szerint egyezik a hibatípusokkal. A catch blokkok a megadott .NET-keretrendszer kivételosztály vagy a megadott osztályból származó bármely osztály hibáit kezelik. Az alábbi példa egy olyan blokkot catch tartalmaz, amely a "Parancs nem található" hibaüzenetet kapja:
catch [System.Management.Automation.CommandNotFoundException]
{"Inherited Exception" }
A megadott hibatípus, a CommandNotFoundException a System.SystemException típustól öröklődik. Az alábbi példa a Nem található parancs hibát is észleli:
catch [System.SystemException] {"Base Exception" }
Ez a catch blokk kezeli a "Parancs nem található" hibát és a SystemException típustól öröklő egyéb hibákat.
Ha egy hibaosztályt és annak egyik származtatott osztályát adja meg, helyezze a catch származtatott osztály blokkját az catch általános osztály blokkja elé.
Feljegyzés
A PowerShell a RuntimeException típus összes kivételét körbefuttatja. Ezért a System.Management.Automation.RuntimeException hibatípus megadása ugyanúgy viselkedik, mint egy nem minősített fogási blokk.
Traps használata a Try Catchben
Ha egy blokkban egy adott blokkban tryTraptry megszűnik a hiba, még akkor is, ha van egyező catch blokk, az utasítás átveszi az Trap irányítást.
Ha az Trap aktuális hatókörön trybelül nem található egyező catch blokk, akkor a rendszer akkor is átveheti az Trap irányítást, ha a szülőhatókör egyező catch blokkot használ.
Kivételadatok elérése
catch Egy blokkon belül az aktuális hiba elérhető $_az úgynevezett .$PSItem Az objektum Type ErrorRecord típusú.
try { NonsenseString }
catch {
Write-Host "An error occurred:"
Write-Host $_
}
A szkript futtatása a következő eredményt adja vissza:
An Error occurred:
The term 'NonsenseString' is not recognized as the name of a cmdlet, function,
script file, or operable program. Check the spelling of the name, or if a path
was included, verify that the path is correct and try again.
További elérhető tulajdonságok is elérhetők, például a ScriptStackTrace, a Exception és az ErrorDetails. Ha például a szkriptet a következőre módosítjuk:
try { NonsenseString }
catch {
Write-Host "An error occurred:"
Write-Host $_.ScriptStackTrace
}
Az eredmény a következőhöz hasonló lesz:
An Error occurred:
at <ScriptBlock>, <No file>: line 2
Erőforrások felszabadítása végül
A szkriptek által használt erőforrások felszabadításához adjon hozzá egy blokkot finally a catchtry blokkok után. A finally blokk-utasítások attól függetlenül futnak, hogy a try blokk végződési hibába ütközik-e. A PowerShell futtatja a blokkot, finally mielőtt a szkript leáll, vagy mielőtt az aktuális blokk kiesik a hatókörből.
A finally blokk akkor is lefut, ha a CTRL C billentyűkombinációval+ állítja le a szkriptet. A finally blokk akkor is lefut, ha egy kilépési kulcsszó leállítja a szkriptet egy catch blokkon belülről.
