about_Throw
Rövid leírás
throw
A megszüntetési hibát generáló kulcsszót ismerteti.
Hosszú leírás
A throw
kulcsszó végződési hibát okoz. A kulcsszóval throw
leállíthatja a parancsok, függvények vagy szkriptek feldolgozását.
A kulcsszót például egy utasítás szkriptblokkjában használhatja arra, hogy reagáljon egy feltételre vagy egycatch
finally
try
-catch
-utasítás blokkjára.if
throw
A throw
kulcsszó bármilyen objektumot képes eldobni, például egy felhasználói üzenet sztringet vagy a hibát okozó objektumot.
Syntax
A kulcsszó szintaxisa a throw
következő:
throw [<expression>]
A szintaxisban szereplő throw
kifejezés nem kötelező. Ha az throw
utasítás nem jelenik meg egy catch
blokkban, és nem tartalmaz kifejezést, szkripthalted hibát okoz.
throw
Exception: ScriptHalted
Ha a throw
kulcsszó kifejezés catch
nélküli blokkban van használva, az ismét az aktuális RuntimeExceptiont dobja. További információ: about_Try_Catch_Finally.
Sztring dobása
Az utasítás opcionális throw
kifejezése lehet sztring, ahogyan az alábbi példában is látható:
throw "This is an error."
Exception: This is an error.
Más objektumok dobása
A kifejezés lehet olyan objektum is, amely a PowerShell-folyamatot jelképező objektumot dobja, ahogyan az az alábbi példában is látható:
throw (Get-Process pwsh)
Exception: System.Diagnostics.Process (pwsh) System.Diagnostics.Process (pwsh) System.Diagnostics.Process (pwsh)
Az automatikus változóban $Error
az ErrorRecord objektum TargetObject tulajdonságával megvizsgálhatja a hibát.
$Error[0].TargetObject
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
125 174.44 229.57 23.61 1548 2 pwsh
63 44.07 81.95 1.75 1732 2 pwsh
63 43.32 77.65 1.48 9092 2 pwsh
ErrorRecord objektumot vagy .NET-kivételt is throw
megadhat. Az alábbi példa a throw
kulcsszót használja a System.FormatException objektum eldobásához.
$formatError = New-Object System.FormatException
throw $formatError
OperationStopped: One of the identified items was in an invalid format.
Az eredményként kapott hiba
A throw
kulcsszó létrehozhat egy ErrorRecord objektumot . Az ErrorRecord objektum Kivétel tulajdonsága runtimeException objektumot tartalmaz.
Az ErrorRecord objektum és a RuntimeException objektum fennmaradó része a kidobott objektumtól függően változik.
Az throw
objektum egy ErrorRecord objektumba van csomagolva, és a ErrorRecord objektum automatikusan az automatikus változóba $Error
lesz mentve.
Kötelező throw
paraméter létrehozása
A PowerShell korábbi verzióival ellentétben ne használja a kulcsszót a throw
paraméterérvényesítéshez. A helyes útért tekintse meg a about_Functions_Advanced_Parameters .