Partilhar via

about_Throw

Breve descrição

Descreve a palavra-chave throw que gera um erro de encerramento.

Descrição longa

A palavra-chave throw causa um erro de encerramento. Você pode usar a palavra-chave throw para interromper o processamento de um comando, função ou script.

Por exemplo, pode usar a throw palavra-chave no bloco de instruções de uma if instrução para responder a uma condição ou no catch bloco de uma try/catch/finally afirmação.

A palavra-chave throw pode lançar qualquer objeto, como uma cadeia de caracteres de mensagem do usuário ou o objeto que causou o erro.

Sintaxe

A sintaxe da palavra-chave throw é a seguinte:

throw [<expression>]

A expressão na sintaxe throw é opcional. Quando a instrução throw não aparece em um bloco catch e não inclui uma expressão, ela gera um erro ScriptHalted.

throw

Exception: ScriptHalted

Se a palavra-chave throw for usada em um bloco catch sem uma expressão, ela lançará o RuntimeException atual novamente. Para obter mais informações, consulte about_Try_Catch_Finally.

Jogando uma corda

A expressão opcional em uma instrução throw pode ser uma cadeia de caracteres, conforme mostrado no exemplo a seguir:

throw "This is an error."

Exception: This is an error.

Atirar outros objetos

A expressão também pode ser um objeto que lança o objeto que representa o processo do PowerShell, conforme mostrado no exemplo a seguir:

throw (Get-Process pwsh)

Exception: System.Diagnostics.Process (pwsh) System.Diagnostics.Process (pwsh) System.Diagnostics.Process (pwsh)

Você pode usar a propriedade TargetObject do objeto ErrorRecord na variável automática $Error para examinar o erro.

$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

Você também pode throw um objeto ErrorRecord ou uma exceção .NET. O exemplo a seguir usa a palavra-chave throw para lançar um objeto System.FormatException.

$formatError = New-Object System.FormatException
throw $formatError

OperationStopped: One of the identified items was in an invalid format.

O erro resultante

A palavra-chave throw pode gerar um objeto ErrorRecord. A propriedade Exception do objeto ErrorRecord contém um objeto RuntimeException. O restante do objeto ErrorRecord e o objeto RuntimeException varia dependendo do objeto lançado.

O objeto throw é encapsulado em um objeto ErrorRecord e o objeto ErrorRecord é salvo automaticamente na variável automática $Error.

Usando throw para criar um parâmetro obrigatório

Ao contrário das versões anteriores do PowerShell, não use a palavra-chave throw para validação de parâmetros. Veja about_Functions_Advanced_Parameters para a maneira correta.

Consulte também

  • Last updated on