Classe System.NotImplementedException

Este artigo fornece comentários complementares à documentação de referência para esta API.

A exceção NotImplementedException é gerada quando um determinado método, acessador get ou acessador set está presente como membro de um tipo, mas não é implementado.

NotImplementedException usa a implementação padrão Object.Equals , que dá suporte à igualdade de referência. Para obter uma lista de valores iniciais de uma instância de NotImplementedException, consulte os construtores de NotImplementedException.

Gerar a exceção

Você pode optar por gerar uma exceção NotImplementedException em propriedades ou métodos em seus próprios tipos quando esse membro ainda estiver em desenvolvimento e só for implementado no código de produção posteriormente. Em outras palavras, uma NotImplementedException exceção deve ser sinônimo de "ainda em desenvolvimento".

Gerar a exceção

A NotImplementedException exceção indica que o método ou a propriedade que você está tentando invocar não tem nenhuma implementação e, portanto, não fornece nenhuma funcionalidade. Como resultado, você não deve tratar esse erro dentro de um bloco try/catch. Em vez disso, você deve remover a invocação de membros do seu código. Você pode incluir uma chamada para o membro quando ela for implementada na versão de produção de uma biblioteca.

Em alguns casos, uma exceção NotImplementedException pode não ser usada para indicar que a funcionalidade ainda está em desenvolvimento em uma biblioteca de pré-produção. No entanto, isso ainda indica que a funcionalidade está indisponível e você deve remover a invocação de membro do código.

NotImplementedException e outros tipos de exceção

O .NET também inclui dois outros tipos de exceção, NotSupportedException e PlatformNotSupportedException, que indicam que não existe nenhuma implementação para um membro específico de um tipo. Você deve gerar um desses em vez de uma exceção NotImplementedException sob as seguintes condições:

• Lance uma PlatformNotSupportedException exceção em plataformas nas quais a funcionalidade não é suportada se você tiver projetado um tipo com um ou mais membros disponíveis em algumas plataformas ou versões, mas não em outras.

• Gere uma NotSupportedException exceção se a implementação de um membro da interface ou uma substituição a um método de classe base abstrata não for possível.

  Por exemplo, o método Convert.ToInt32(DateTime) gera uma exceção NotSupportedException porque não existe nenhuma conversão significativa entre uma data e hora e um inteiro assinado de 32 bits. O método deve estar presente nesse caso porque a Convert classe implementa a IConvertible interface.

Você também deverá gerar uma NotSupportedException exceção se tiver implementado uma classe base abstrata e adicionar um novo membro a ela que deve ser substituído por classes derivadas. Nesse caso, tornar o membro abstrato faz com que as subclasses existentes falhem ao carregar.