Home Biblioteca Aprender Galeria Downloads Suporte Comunidade Fóruns
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe InvalidEnumArgumentException

.NET Framework 4.5

A exceção gerada ao usar argumentos inválidos que estão enumeradores.

System.Object
  System.Exception
    System.SystemException
      System.ArgumentException
        System.ComponentModel.InvalidEnumArgumentException

Namespace:  System.ComponentModel
Assembly:  System (em System.dll)
C#
C++
F#
VB
Copiar 
[SerializableAttribute]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class InvalidEnumArgumentException : ArgumentException

O tipo InvalidEnumArgumentException expõe os membros a seguir.

  NomeDescrição
Método públicoInvalidEnumArgumentException()Inicializa uma nova instância da InvalidEnumArgumentException classe sem uma mensagem.
Método públicoInvalidEnumArgumentException(String)Inicializa uma nova instância da InvalidEnumArgumentException classe com a mensagem especificada.
Método protegidoInvalidEnumArgumentException(SerializationInfo, StreamingContext)Inicializa uma nova instância da InvalidEnumArgumentException usando os dados de serialização especificado e o contexto de classe.
Método públicoInvalidEnumArgumentException(String, Exception)Inicializa uma nova instância da InvalidEnumArgumentException classe com a descrição detalhada especificada e a exceção especificada.
Método públicoInvalidEnumArgumentException(String, Int32, Type)Inicializa uma nova instância da InvalidEnumArgumentException classe com uma mensagem gerada a partir de uma classe de enumeração, o valor inválido e o argumento.
Superior
  NomeDescrição
Propriedade públicaDataObtém uma coleção de pares chave/valor que fornecem informações definido pelo usuário adicionais sobre a exceção. (Herdado de Exception.)
Propriedade públicaHelpLinkObtém ou define um link para o arquivo de ajuda associado a esta exceção. (Herdado de Exception.)
Propriedade públicaHResultObtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception.)
Propriedade públicaInnerExceptionObtém a instância de Exception que causou a exceção atual. (Herdado de Exception.)
Propriedade públicaMessageRecebe a mensagem de erro e o nome de parâmetro, ou apenas a mensagem de erro se nenhum nome de parâmetro é definido. (Herdado de ArgumentException.)
Propriedade públicaParamNameObtém o nome do parâmetro que lança esta exceção. (Herdado de ArgumentException.)
Propriedade públicaSourceObtém ou define o nome do aplicativo ou do objeto que faz com que o erro. (Herdado de Exception.)
Propriedade públicaStackTraceObtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas. (Herdado de Exception.)
Propriedade públicaTargetSiteObtém o método que gera a exceção atual. (Herdado de Exception.)
Superior
  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetBaseExceptionQuando substituído em uma classe derivada, retorna Exception que é a raiz causa de uma ou mais exceções subseqüentes. (Herdado de Exception.)
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetObjectDataDefina o objeto de SerializationInfo com o nome do parâmetro e informações adicionais de exceção. (Herdado de ArgumentException.)
Método públicoGetTypeObtém o tipo de tempo de execução da instância atual. (Herdado de Exception.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoToStringCria e retorna uma representação de cadeia de caracteres de exceção atual. (Herdado de Exception.)
Superior
  NomeDescrição
Evento protegidoSerializeObjectStateOcorre quando uma exceção é serializada para criar um objeto de estado da exceção que contém dados serializados sobre a exceção. (Herdado de Exception.)
Superior

Essa exceção é lançada se você passar um valor de enumeração inválido para um método ou ao definir uma propriedade.

ObservaçãoObservação

O atributo HostProtectionAttribute aplicado a este tipo ou membro tem o seguinte valor da propriedade Resources: SharedState. HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador). Para obter mais informações, consulte a classe HostProtectionAttribute ou Atributos de proteção de Host e programação de SQL Server.

O exemplo de código a seguir mostra como capturar uma InvalidEnumArgumentException exceção e interpretar seu conteúdo. O exemplo tenta passar um valor de enumeração inválido (MessageBoxButtons) através de elenco, como o MessageBox.Show terceiro de argumento do método. Após a captura a exceção, o exemplo de busca a mensagem de erro respectivos, o parâmetro inválido, rastreamento de pilha e origem da exceção.

C#
C++
VB
Copiar 

		try 
		{
		// Attempts to pass an invalid enum value (MessageBoxButtons) to the Show method
		    MessageBoxButtons myButton= (MessageBoxButtons) 123;
		    MessageBox.Show("This is a message","This is the Caption",myButton);
		}
		catch(InvalidEnumArgumentException invE) 
		{
		    Console.WriteLine(invE.Message);
		    Console.WriteLine(invE.ParamName);
		    Console.WriteLine(invE.StackTrace);
		    Console.WriteLine(invE.Source);
		}

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.
Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
© 2013 Microsoft. Todos os direitos reservados.