O aplikaci Throw

KRÁTKÝ POPIS

Popisuje klíčové slovo Throw, které generuje ukončující chybu.

DLOUHÝ POPIS

Klíčové slovo Throw způsobí ukončovací chybu. Klíčové slovo Throw můžete použít k zastavení zpracování příkazu, funkce nebo skriptu.

Můžete například použít klíčové slovo Throw v bloku skriptu příkazu If pro reakci na podmínku nebo v bloku Catch příkazu Try-Catch-Finally. Můžete také použít klíčové slovo Throw v deklaraci parametru, aby byl parametr funkce povinný.

Klíčové slovo Throw může vyvolat libovolný objekt, například řetězec zprávy uživatele nebo objekt, který chybu způsobil.

Syntaktika

Syntaxe klíčového slova Throw je následující:

throw [<expression>]

Výraz v syntaxi Throw je nepovinný. Pokud se příkaz Throw nezobrazí v bloku Catch a neobsahuje výraz, vygeneruje chybu ScriptHalted.

C:\PS> throw

ScriptHalted
At line:1 char:6
+ throw <<<<
+ CategoryInfo          : OperationStopped: (:) [], RuntimeException
+ FullyQualifiedErrorId : ScriptHalted

Pokud je klíčové slovo Throw použito v bloku Catch bez výrazu, vyvolá znovu aktuální výjimku RuntimeException. Další informace naleznete v části about_Try_Catch_Finally.

HOZENÍ PROVÁZKU

Volitelný výraz v příkazu Throw může být řetězec, jak je znázorněno v následujícím příkladu:

C:\PS> throw "This is an error."

This is an error.
At line:1 char:6
+ throw <<<<  "This is an error."
+ CategoryInfo          : OperationStopped: (This is an error.:String) [], R
untimeException
+ FullyQualifiedErrorId : This is an error.

HÁZENÍ JINÝCH PŘEDMĚTŮ

Výraz může být také objekt, který vyvolá objekt, který představuje proces PowerShellu, jak je znázorněno v následujícím příkladu:

C:\PS> throw (get-process PowerShell)

System.Diagnostics.Process (PowerShell)
At line:1 char:6
+ throw <<<<  (get-process PowerShell)
+ CategoryInfo          : OperationStopped: (System.Diagnostics.Process (Pow
erShell):Process) [],
RuntimeException
+ FullyQualifiedErrorId : System.Diagnostics.Process (PowerShell)

Ke kontrole chyby můžete použít vlastnost TargetObject objektu ErrorRecord v automatické proměnné $error.

C:\PS> $error[0].targetobject

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
319      26    61016      70864   568     3.28   5548 PowerShell

Můžete také vyvolat objekt ErrorRecord nebo výjimku rozhraní Microsoft .NET Framework. Následující příklad používá klíčové slovo Throw k vyvolání objektu System.FormatException.

C:\PS> $formatError = new-object system.formatexception

C:\PS> throw $formatError

One of the identified items was in an invalid format.
At line:1 char:6
+ throw <<<<  $formatError
+ CategoryInfo          : OperationStopped: (:) [], FormatException
+ FullyQualifiedErrorId : One of the identified items was in an invalid
format.

VÝSLEDNÁ CHYBA

Klíčové slovo Throw může vygenerovat objekt ErrorRecord. Vlastnost Exception objektu ErrorRecord obsahuje objekt RuntimeException. Zbytek objektu ErrorRecord a objektu RuntimeException se liší podle objektu, který vyvolá klíčové slovo Throw.

Objekt RunTimeException je zabalen do objektu ErrorRecord a objekt ErrorRecord je automaticky uložen do $Error automatické proměnné.

POUŽITÍ FUNKCE THROW K VYTVOŘENÍ POVINNÉHO PARAMETRU

Pomocí klíčového slova Throw můžete nastavit parametr funkce jako povinný.

Jedná se o alternativu k použití parametru Povinný parametr klíčového slova Parameter. Když použijete povinný parametr, systém vyzve uživatele k zadání požadované hodnoty parametru. Při použití klíčového slova Throw se příkaz zastaví a zobrazí záznam chyby.

Například klíčové slovo Throw v dílčím výrazu parametru udělá z parametru Path povinný parametr ve funkci.

V tomto případě klíčové slovo Throw vyvolá řetězec zprávy, ale je to přítomnost klíčového slova Throw, která generuje ukončující chybu, pokud parametr Path není zadán. Výraz, který následuje za výrazem Throw, je nepovinný.

function Get-XMLFiles
{
  param ($path = $(throw "The Path parameter is required."))
  dir -path $path\*.xml -recurse |
    sort lastwritetime |
      ft lastwritetime, attributes, name  -auto
}

VIZ TAKÉ

o_Pauze

o_Pokračovat

about_Scopes

about_Trap

informace_o_Try_Catch_Finally