21 Exceções
21.1 Geral
As exceções em C# fornecem uma maneira estruturada, uniforme e segura de lidar com condições de erro no nível do sistema e no nível do aplicativo.
21.2 Causas de exceções
As exceções podem ser lançadas de duas maneiras diferentes.
- Uma
throw
instrução (§13.10.6) gera uma exceção imediata e incondicionalmente. O controle nunca alcança a instrução imediatamente após othrow
. - Determinadas condições excepcionais que surgem durante o processamento de instruções e expressões C# fazem com que uma exceção seja lançada em determinadas circunstâncias quando a operação não pode ser concluída normalmente. Consulte §21.5 para obter uma lista das várias exceções que podem ser lançadas dessa maneira.
Exemplo: uma operação de divisão inteira (§12.10.3) gera um
System.DivideByZeroException
se o denominador for zero. exemplo de fim
21.3 A classe System.Exception
A System.Exception
classe é o tipo base de todas as exceções. Essa classe tem algumas propriedades notáveis que todas as exceções compartilham:
Message
é uma propriedade somente leitura do tipostring
que contém uma descrição legível do motivo da exceção.InnerException
é uma propriedade somente leitura do tipoException
. Se seu valor for non-null
, ele se referirá à exceção que causou a exceção atual. (Ou seja, a exceção atual foi gerada em um bloco catch que manipula oInnerException
.) Caso contrário, seu valor seránull
, indicando que essa exceção não foi causada por outra exceção. O número de objetos de exceção encadeados dessa maneira pode ser arbitrário.
O valor dessas propriedades pode ser especificado em chamadas para o construtor de instância para System.Exception
.
21.4 Como as exceções são tratadas
As exceções são tratadas por uma try
instrução (§13.11).
Quando uma exceção é lançada (§21.2), o sistema procura a cláusula catch mais próxima que pode lidar com a exceção, conforme determinado pelo tipo de tempo de execução da exceção. Primeiro, o método atual é pesquisado por uma declaração delimitadora try
lexical, e as cláusulas associadas catch
da try
instrução são consideradas em ordem. Se isso falhar, o método que chamou o método atual será pesquisado por uma instrução lexicalmente delimitadora try
que inclua o ponto da chamada para o método atual. Essa pesquisa continua até que seja encontrada uma catch
cláusula que possa lidar com a exceção atual, nomeando uma classe de exceção que seja da mesma classe, ou uma classe base, do tipo de tempo de execução da exceção que está sendo lançada. Uma catch
cláusula que não nomeia uma classe de exceção pode lidar com qualquer exceção.
Depois que uma cláusula correspondente catch
é encontrada, o sistema se prepara para transferir o controle para a primeira instrução da catch
cláusula. Antes do início da execução da catch
cláusula, o sistema primeiro executa, em ordem, todas as finally
cláusulas que foram associadas a try
instruções mais aninhadas do que aquela que capturou a exceção.
Se nenhuma cláusula correspondente catch
for encontrada:
- Se a pesquisa por uma cláusula correspondente
catch
atingir um construtor estático (§15.12) ou inicializador de campo estático, aSystem.TypeInitializationException
será lançado no ponto que disparou a invocação do construtor estático. A exceção interna doSystem.TypeInitializationException
contém a exceção que foi originalmente lançada. - Caso contrário, se ocorrer uma exceção durante a execução do finalizador e essa exceção não for capturada, o comportamento não será especificado.
- Caso contrário, se a pesquisa de cláusulas correspondentes
catch
atingir o código que iniciou inicialmente o thread, a execução do thread será encerrada. O impacto de tal rescisão é definido pela implementação.
21.5 Classes de exceção comuns
As exceções a seguir são geradas por determinadas operações C#.
Tipo de exceção | Descrição |
---|---|
System.ArithmeticException |
Uma classe base para exceções que ocorrem durante operações aritméticas, tais como System.DivideByZeroException e System.OverflowException . |
System.ArrayTypeMismatchException |
Lançado quando um armazenamento em uma matriz falha porque o tipo do elemento armazenado é incompatível com o tipo da matriz. |
System.DivideByZeroException |
Lançado quando ocorre uma tentativa de dividir um valor integral por zero. |
System.IndexOutOfRangeException |
Lançado quando uma tentativa de indexar uma matriz por meio de um índice menor que zero ou fora dos limites da matriz. |
System.InvalidCastException |
Lançada quando uma conversão explícita de um tipo base ou interface para um tipo derivado falha em tempo de execução. |
System.NullReferenceException |
Lançado quando uma null referência é usada de uma forma que faz com que o objeto referenciado seja necessário. |
System.OutOfMemoryException |
Lançado quando uma tentativa de alocar memória (via new ) falha. |
System.OverflowException |
Lançada quando uma operação aritmética em um contexto checked estoura. |
System.StackOverflowException |
Lançado quando a pilha de execução está esgotada por ter muitas chamadas pendentes; Normalmente indicativo de recursão muito profunda ou ilimitada. |
System.TypeInitializationException |
Lançado quando um construtor estático ou inicializador de campo estático lança uma exceção e não existe nenhuma catch cláusula para capturá-la. |
ECMA C# draft specification