InvalidEnumArgumentException 類別
定義
使用為列舉值的無效引數時,會將例外狀況 (Exception) 擲回。The exception thrown when using invalid arguments that are enumerators.
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
- 繼承
- 屬性
範例
下列程式碼範例示範如何攔截例外狀況 InvalidEnumArgumentException 並解讀其內容。The following code example shows how to catch an InvalidEnumArgumentException exception and interpret its content. 此範例會嘗試將不正確列舉值 (MessageBoxButtons
) 透過轉換來傳遞,作為 MessageBox.Show 方法的第三個引數。The example attempts to pass an invalid enumeration value (MessageBoxButtons
) through casting, as the MessageBox.Show method's third argument. 攔截到例外狀況時,此範例會提取個別的錯誤訊息、不正確參數、堆疊追蹤和例外狀況的來源。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
備註
如果您將不正確列舉值傳遞給方法或設定屬性時,就會擲回這個例外狀況。This exception is thrown if you pass an invalid enumeration value to a method or when setting a property.
建構函式
InvalidEnumArgumentException() |
不使用訊息來初始化 InvalidEnumArgumentException 類別的新執行個體。Initializes a new instance of the InvalidEnumArgumentException class without a message. |
InvalidEnumArgumentException(SerializationInfo, StreamingContext) |
使用指定的序列化資料和內容,初始化 InvalidEnumArgumentException 類別的新執行個體。Initializes a new instance of the InvalidEnumArgumentException class using the specified serialization data and context. |
InvalidEnumArgumentException(String) |
使用指定的訊息初始化 InvalidEnumArgumentException 類別的新執行個體。Initializes a new instance of the InvalidEnumArgumentException class with the specified message. |
InvalidEnumArgumentException(String, Exception) |
使用指定的詳細描述和指定的例外狀況,初始化 InvalidEnumArgumentException 類別的新執行個體。Initializes a new instance of the InvalidEnumArgumentException class with the specified detailed description and the specified exception. |
InvalidEnumArgumentException(String, Int32, Type) |
使用引數、無效值和列舉型別 (Enumeration) 類別所產生的訊息來初始化 InvalidEnumArgumentException 類別的新執行個體。Initializes a new instance of the InvalidEnumArgumentException class with a message generated from the argument, the invalid value, and an enumeration class. |
屬性
Data |
取得鍵值組的集合,這些鍵值組會提供關於例外狀況的其他使用者定義資訊。Gets a collection of key/value pairs that provide additional user-defined information about the exception. (繼承來源 Exception) |
HelpLink |
取得或設定與這個例外狀況相關聯的說明檔連結。Gets or sets a link to the help file associated with this exception. (繼承來源 Exception) |
HResult |
取得或設定 HRESULT,它是指派給特定例外狀況的編碼數值。Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (繼承來源 Exception) |
InnerException |
取得造成目前例外狀況的 Exception 執行個體。Gets the Exception instance that caused the current exception. (繼承來源 Exception) |
Message |
取得錯誤訊息和參數名稱,在參數名稱未設定時只會取得錯誤訊息。Gets the error message and the parameter name, or only the error message if no parameter name is set. (繼承來源 ArgumentException) |
ParamName |
取得造成這個例外狀況的參數名稱。Gets the name of the parameter that causes this exception. (繼承來源 ArgumentException) |
Source |
取得或設定造成錯誤的應用程式或物件的名稱。Gets or sets the name of the application or the object that causes the error. (繼承來源 Exception) |
StackTrace |
取得呼叫堆疊上即時運算框架的字串表示。Gets a string representation of the immediate frames on the call stack. (繼承來源 Exception) |
TargetSite |
取得擲回目前例外狀況的方法。Gets the method that throws the current exception. (繼承來源 Exception) |
方法
Equals(Object) |
判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object. (繼承來源 Object) |
GetBaseException() |
在衍生類別中覆寫時,傳回一或多個後續的例外狀況的根本原因 Exception。When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (繼承來源 Exception) |
GetHashCode() |
做為預設雜湊函式。Serves as the default hash function. (繼承來源 Object) |
GetObjectData(SerializationInfo, StreamingContext) |
設定具有參數名稱和額外例外狀況資訊的 SerializationInfo 物件。Sets the SerializationInfo object with the parameter name and additional exception information. (繼承來源 ArgumentException) |
GetType() |
取得目前執行個體的執行階段類型。Gets the runtime type of the current instance. (繼承來源 Exception) |
MemberwiseClone() |
建立目前 Object 的淺層複製。Creates a shallow copy of the current Object. (繼承來源 Object) |
ToString() |
建立並傳回目前例外狀況的字串表示。Creates and returns a string representation of the current exception. (繼承來源 Exception) |
事件
SerializeObjectState |
當例外狀況序列化,以建立包含例外狀況相關序列化資料的例外狀況狀態物件時,就會發生此事件。Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception. (繼承來源 Exception) |