InvalidEnumArgumentException Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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) |