InvalidEnumArgumentException Класс

Определение

Пространство имен:

System.ComponentModel

Сборка:

System.dll

Исключение, которое возникает при использовании недопустимого значения перечисления.

public ref class InvalidEnumArgumentException : ArgumentException

[System.Serializable]
public class InvalidEnumArgumentException : ArgumentException

[<System.Serializable>]
type InvalidEnumArgumentException = class
    inherit ArgumentException

Public Class InvalidEnumArgumentException
Inherits ArgumentException

Наследование

Object

Exception

SystemException

ArgumentException

InvalidEnumArgumentException

Атрибуты

SerializableAttribute

Примеры

В следующем примере кода показано, как перехватывать InvalidEnumArgumentException исключение и интерпретировать его содержимое. В примере выполняется попытка передать недопустимое значение перечисления (MessageBoxButtons) путем приведения в качестве MessageBox.Show третьего аргумента метода. При перехвате исключения пример получает соответствующее сообщение об ошибке, недопустимый параметр, трассировку стека и источник исключения.

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

Комментарии

Это исключение возникает при передаче недопустимого значения перечисления методу или при задании свойства.

Конструкторы

Имя	Описание
InvalidEnumArgumentException()	Инициализирует новый экземпляр InvalidEnumArgumentException класса без сообщения.
InvalidEnumArgumentException(SerializationInfo, StreamingContext)	Инициализирует новый экземпляр InvalidEnumArgumentException класса с помощью указанных данных сериализации и контекста.
InvalidEnumArgumentException(String, Exception)	Инициализирует новый экземпляр InvalidEnumArgumentException класса с указанным подробным описанием и указанным исключением.
InvalidEnumArgumentException(String, Int32, Type)	Инициализирует новый экземпляр InvalidEnumArgumentException класса с сообщением, созданным из аргумента, недопустимым значением и классом перечисления.
InvalidEnumArgumentException(String)	Инициализирует новый экземпляр InvalidEnumArgumentException класса с указанным сообщением.

Свойства

Имя	Описание
Data	Возвращает коллекцию пар "ключ-значение", которые предоставляют дополнительные пользовательские сведения об исключении. (Унаследовано от Exception)
HelpLink	Возвращает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception)
HResult	Возвращает или задает HRESULT, закодированное числовое значение, назначенное определенному исключению. (Унаследовано от Exception)
InnerException	Возвращает экземпляр Exception, вызвавшего текущее исключение. (Унаследовано от Exception)
Message	Возвращает сообщение об ошибке и имя параметра или только сообщение об ошибке, если имя параметра не задано. (Унаследовано от ArgumentException)
ParamName	Возвращает имя параметра, вызывающего это исключение. (Унаследовано от ArgumentException)
Source	Возвращает или задает имя приложения или объекта, вызывающего ошибку. (Унаследовано от Exception)
StackTrace	Возвращает строковое представление непосредственных кадров в стеке вызовов. (Унаследовано от Exception)
TargetSite	Возвращает метод, который вызывает текущее исключение. (Унаследовано от Exception)

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBaseException()	При переопределении в производном классе возвращает Exception, которая является основной причиной одного или нескольких последующих исключений. (Унаследовано от Exception)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo Задает объект с именем параметра и дополнительными сведениями об исключении. (Унаследовано от ArgumentException)
GetType()	Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

Имя	Описание
SerializeObjectState	Происходит при сериализации исключения для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception)