Erros e exceções no sistema de tipo estendido

Erros podem ocorrer no ETS durante a inicialização de dados de tipo e ao acessar um membro de um objeto de PSObject ou usando uma das classes de utilitário, como LanguagePrimitives.

Erros de tempo de execução

Com uma exceção, durante a transmissão, todas as exceções lançadas do ETS durante o tempo de execução são uma exceção ExtendedTypeSystemException ou uma exceção derivada da classe ExtendedTypeSystemException. Isso permite que os desenvolvedores de scripts intercetem essas exceções usando a instrução trap em seu script.

Erros ao obter valores de membro

Todos os erros que ocorrem ao obter o valor de um membro do ETS (propriedade, método ou propriedade parametrizada) fazem com que uma GetValueException ou exceção GetValueInvocationException seja lançada. Quando o ETS reconhece que ocorreu um erro, uma exceção de GetValueException é lançada. Quando o getter subjacente de um membro referenciado reconhece que ocorreu um erro, é lançada uma exceção de GetValueInvocationException que pode ou não incluir a exceção interna que causou o erro de invocação get.

Erros ao definir valores de membro

Todos os erros que ocorrem ao definir o valor de uma propriedade ETS fazem com que uma SetValueException ou SetValueInvocationException exceção seja lançada. Quando o ETS reconhece que ocorreu um erro, uma exceção de SetValueException é lançada. Quando o setter subjacente de uma propriedade referenciada reconhece que ocorreu um erro, é lançada uma exceção de SetValueInvocationException que pode ou não incluir a exceção interna que causou o erro de invocação do conjunto.

Erros ao invocar um método

Todos os erros que ocorrem ao invocar um método ETS fazem com que uma exceção MethodException ou MethodInvocationException seja lançada. Quando o ETS reconhece que ocorreu um erro, uma exceção MethodException é lançada. Quando o método referenciado reconhece que ocorreu um erro, é lançada uma exceção MethodInvocationException que pode ou não incluir a exceção interna que causou o erro de invocação.

Erros de transmissão

Quando uma conversão inválida é tentada, uma PSInvalidCastException é lançada. Como essa exceção deriva de System.InvalidCastException, ela não pode ser diretamente presa do script. Lembre-se de que a entidade que tenta o cast precisaria encapsular PSInvalidCastException em um PSRuntimeException para que isso possa ser intercetado por scripts. Se for feita uma tentativa de definir o valor de um PSPropertySet , PSMemberSet, PSMethodInfo, ou um membro do ReadOnlyPSMemberInfoCollection'1 , um NotSupportedException é lançado.

Erros comuns de tempo de execução

Quaisquer outros erros comuns de tempo de execução que ocorrem são do tipo exceção ExtendedTypeSystemException sem tipos de exceção específicos adicionais.

Erros de inicialização

Erros podem ocorrer ao inicializar types.ps1xml. Normalmente, esses erros são exibidos quando o tempo de execução do PowerShell é iniciado. No entanto, eles também podem ser exibidos quando um módulo é carregado.