InvalidEnumArgumentException Classe

Definição

A exceção que é lançada quando é usado um valor de enumeração inválido.

public ref class InvalidEnumArgumentException : ArgumentException
public class InvalidEnumArgumentException : ArgumentException
[System.Serializable]
public class InvalidEnumArgumentException : ArgumentException
type InvalidEnumArgumentException = class
    inherit ArgumentException
[<System.Serializable>]
type InvalidEnumArgumentException = class
    inherit ArgumentException
Public Class InvalidEnumArgumentException
Inherits ArgumentException
Herança
InvalidEnumArgumentException
Atributos

Exemplos

O seguinte exemplo de código mostra como detetar uma InvalidEnumArgumentException exceção e interpretar o seu conteúdo. O exemplo tenta passar um valor de enumeração inválido (MessageBoxButtons) através do casting, como terceiro MessageBox.Show argumento do método. Ao detetar a exceção, o exemplo obtém a respetiva mensagem de erro, o parâmetro inválido, o traço de pilha e a origem da exceção.

try
{
   //Attempting to pass an invalid enum value (MessageBoxButtons) to the Show method
   MessageBoxButtons myButton = (MessageBoxButtons)123; // to fix use System::Windows::Forms::DialogResult::OK;

   MessageBox::Show( this,  "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 );
}
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);
}
Try
    ' Attempts to pass an invalid enum value (MessageBoxButtons) to the Show method
    Dim myButton As MessageBoxButtons
    myButton = CType(123, MessageBoxButtons)
    MessageBox.Show("This is a message", "This is the Caption", myButton)
Catch invE As System.ComponentModel.InvalidEnumArgumentException
    Console.WriteLine(invE.Message)
    Console.WriteLine(invE.ParamName)
    Console.WriteLine(invE.StackTrace)
    Console.WriteLine(invE.Source)
End Try

Observações

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

Construtores

Name Description
InvalidEnumArgumentException()

Inicializa uma nova instância da InvalidEnumArgumentException classe sem mensagem.

InvalidEnumArgumentException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da InvalidEnumArgumentException classe usando os dados e contexto de serialização especificados.

InvalidEnumArgumentException(String, Exception)

Inicializa uma nova instância da InvalidEnumArgumentException classe com a descrição detalhada especificada e a exceção especificada.

InvalidEnumArgumentException(String, Int32, Type)

Inicializa uma nova instância da InvalidEnumArgumentException classe com uma mensagem gerada a partir do argumento, o valor inválido e uma classe de enumeração.

InvalidEnumArgumentException(String)

Inicializa uma nova instância da InvalidEnumArgumentException classe com a mensagem especificada.

Propriedades

Name Description
Data

Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção.

(Herdado de Exception)
HelpLink

Obtém ou define um link para o ficheiro de ajuda associado a esta exceção.

(Herdado de Exception)
HResult

Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica.

(Herdado de Exception)
InnerException

Obtém a Exception instância que causou a exceção atual.

(Herdado de Exception)
Message

Recebe a mensagem de erro e o nome do parâmetro, ou apenas a mensagem de erro se nenhum nome de parâmetro estiver definido.

(Herdado de ArgumentException)
ParamName

Obtém o nome do parâmetro que causa esta exceção.

(Herdado de ArgumentException)
Source

Obtém ou define o nome do aplicativo ou o objeto que causa o erro.

(Herdado de Exception)
StackTrace

Obtém uma representação string dos frames imediatos na stack de chamadas.

(Herdado de Exception)
TargetSite

Obtém o método que lança a exceção atual.

(Herdado de Exception)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Define o SerializationInfo objeto com o nome do parâmetro e informação adicional de exceção.

(Herdado de ArgumentException)
GetType()

Obtém o tipo de execução da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Cria e devolve uma representação string da exceção atual.

(Herdado de Exception)

evento

Name Description
SerializeObjectState

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.

(Herdado de Exception)

Aplica-se a