InvalidEnumArgumentException InvalidEnumArgumentException InvalidEnumArgumentException InvalidEnumArgumentException Class

Definition

Excepción que se produjo al utilizar argumentos no válidos que son enumeradores. The exception thrown when using invalid arguments that are enumerators.

public ref class InvalidEnumArgumentException : ArgumentException
[Serializable]
public class InvalidEnumArgumentException : ArgumentException
type InvalidEnumArgumentException = class
    inherit ArgumentException
Public Class InvalidEnumArgumentException
Inherits ArgumentException
Inheritance
Attributes
SerializableAttribute

Examples

En el ejemplo de código siguiente se muestra cómo capturar una InvalidEnumArgumentException excepción e interpretar su contenido.The following code example shows how to catch an InvalidEnumArgumentException exception and interpret its content. En el ejemplo se intenta pasar un valor de enumeración no válido (MessageBoxButtons) mediante la conversión, como el MessageBox.Show tercer argumento del método.The example attempts to pass an invalid enumeration value (MessageBoxButtons) through casting, as the MessageBox.Show method's third argument. Tras detectar la excepción, el ejemplo obtiene el mensaje de error correspondiente, el parámetro no válido, el seguimiento de pila y el origen de la excepción.Upon catching the exception, the example fetches the respective error message, the invalid parameter, stack trace, and origin of the exception.

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

Remarks

Esta excepción se produce si se pasa un valor de enumeración no válido a un método o al establecer una propiedad.This exception is thrown if you pass an invalid enumeration value to a method or when setting a property.

Constructors

InvalidEnumArgumentException() InvalidEnumArgumentException() InvalidEnumArgumentException() InvalidEnumArgumentException()

Inicializa una nueva instancia de la clase InvalidEnumArgumentException sin un mensaje. Initializes a new instance of the InvalidEnumArgumentException class without a message.

InvalidEnumArgumentException(SerializationInfo, StreamingContext) InvalidEnumArgumentException(SerializationInfo, StreamingContext) InvalidEnumArgumentException(SerializationInfo, StreamingContext) InvalidEnumArgumentException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase InvalidEnumArgumentException con el contexto y los datos de serialización especificados. Initializes a new instance of the InvalidEnumArgumentException class using the specified serialization data and context.

InvalidEnumArgumentException(String) InvalidEnumArgumentException(String) InvalidEnumArgumentException(String) InvalidEnumArgumentException(String)

Inicializa una nueva instancia de la clase InvalidEnumArgumentException con el mensaje especificado. Initializes a new instance of the InvalidEnumArgumentException class with the specified message.

InvalidEnumArgumentException(String, Exception) InvalidEnumArgumentException(String, Exception) InvalidEnumArgumentException(String, Exception) InvalidEnumArgumentException(String, Exception)

Inicializa una nueva instancia de la clase InvalidEnumArgumentException con la descripción detallada especificada y la excepción especificada. Initializes a new instance of the InvalidEnumArgumentException class with the specified detailed description and the specified exception.

InvalidEnumArgumentException(String, Int32, Type) InvalidEnumArgumentException(String, Int32, Type) InvalidEnumArgumentException(String, Int32, Type) InvalidEnumArgumentException(String, Int32, Type)

Inicializa una nueva instancia de la clase InvalidEnumArgumentException con un mensaje generado a partir del argumento, el valor no válido y una clase de enumeración. Initializes a new instance of the InvalidEnumArgumentException class with a message generated from the argument, the invalid value, and an enumeration class.

Methods

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Cuando se reemplaza en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada. Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Establece el objeto SerializationInfo con el nombre del parámetro y la información adicional de la excepción. Sets the SerializationInfo object with the parameter name and additional exception information.

(Inherited from ArgumentException)
GetType() GetType() GetType() GetType()

Obtiene el tipo en tiempo de ejecución de la instancia actual. Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Crea y devuelve una representación de cadena de la excepción actual. Creates and returns a string representation of the current exception.

(Inherited from Exception)

Properties

Data Data Data Data

Obtiene una colección de pares clave-valor que proporcionan información adicional definida por el usuario acerca de la excepción. Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Obtiene la instancia Exception que produjo la excepción actual. Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Obtiene el mensaje de error y el nombre del parámetro. Si no se estableció ningún nombre de parámetro, obtiene solo el mensaje de error. Gets the error message and the parameter name, or only the error message if no parameter name is set.

(Inherited from ArgumentException)
ParamName ParamName ParamName ParamName

Obtiene el nombre del parámetro que causa esta excepción. Gets the name of the parameter that causes this exception.

(Inherited from ArgumentException)
Source Source Source Source

Devuelve o establece el nombre de la aplicación o del objeto que generó el error. Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Obtiene el método que produjo la excepción actual. Gets the method that throws the current exception.

(Inherited from Exception)

Events

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Se produce cuando se serializa una excepción para crear un objeto de estados de excepción que contiene datos serializados sobre la excepción. Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Applies to