Share via

about_Throw

  • Articolo

Descrizione breve

Descrive la throw parola chiave che genera un errore irreversibile.

Descrizione lunga

La throw parola chiave causa un errore irreversibile. È possibile usare la throw parola chiave per arrestare l'elaborazione di un comando, di una funzione o di uno script.

Ad esempio, è possibile usare la throw parola chiave nel blocco di script di un'istruzione if per rispondere a una condizione o nel blocco di un'istruzionecatch-trycatch-finally.

La throw parola chiave può generare qualsiasi oggetto, ad esempio una stringa di messaggio utente o l'oggetto che ha causato l'errore.

Sintassi

La sintassi della throw parola chiave è la seguente:

throw [<expression>]

L'espressione nella throw sintassi è facoltativa. Quando l'istruzione throw non viene visualizzata in un catch blocco e non include un'espressione, genera un errore ScriptHalted .

throw

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

Se la throw parola chiave viene usata in un catch blocco senza un'espressione, genera nuovamente l'eccezione RuntimeException corrente. Per altre informazioni, vedere about_Try_Catch_Finally.

Creazione di una stringa

L'espressione facoltativa in un'istruzione throw può essere una stringa, come illustrato nell'esempio seguente:

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.

Generare altri oggetti

L'espressione può anche essere un oggetto che genera l'oggetto che rappresenta il processo di PowerShell, come illustrato nell'esempio seguente:

throw (Get-Process pwsh)

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

È possibile utilizzare la proprietà TargetObject dell'oggetto ErrorRecord nella $Error variabile automatica per esaminare l'errore.

$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

È anche throw possibile usare un oggetto ErrorRecord o un'eccezione .NET. Nell'esempio seguente viene utilizzata la throw parola chiave per generare un oggetto System.FormatException .

$formatError = New-Object System.FormatException
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.

Errore risultante

La throw parola chiave può generare un oggetto ErrorRecord . La proprietà Exception dell'oggetto ErrorRecord contiene un oggetto RuntimeException . Il resto dell'oggetto ErrorRecord e l'oggetto RuntimeException variano a seconda dell'oggetto generato.

L'oggetto throw viene sottoposto a wrapping in un oggetto ErrorRecord e l'oggetto ErrorRecord viene salvato automaticamente nella $Error variabile automatica.

Uso throw di per creare un parametro obbligatorio

A differenza delle versioni precedenti di PowerShell, non usare la parola chiave per la throw convalida dei parametri. Vedere about_Functions_Advanced_Parameters per il modo corretto.

Vedi anche