InvalidCastException 建構函式

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

初始化 InvalidCastException 類別的新執行個體。

多載

名稱	Description
InvalidCastException()	初始化 InvalidCastException 類別的新執行個體。
InvalidCastException(String)	初始化類別的新實例 InvalidCastException 並指定錯誤訊息。
InvalidCastException(SerializationInfo, StreamingContext)	已淘汰. 使用串行化數據，初始化 InvalidCastException 類別的新實例。
InvalidCastException(String, Exception)	初始化類別的新實例 InvalidCastException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。
InvalidCastException(String, Int32)	初始化類別的新實例 InvalidCastException ，並以指定的訊息與錯誤代碼。

InvalidCastException()

來源:

InvalidCastException.cs

初始化 InvalidCastException 類別的新執行個體。

public:
 InvalidCastException();

public InvalidCastException();

Public Sub New ()

備註

此建構子會將新實例的屬性初始 Message 化為系統提供的訊息，描述錯誤，例如「無法從來源型別投射到目標型別」。此訊息考量了當前系統文化。

下表顯示了 的 InvalidCastException初始屬性值。

房產	價值
InnerException	一個空參考（Nothing Visual Basic 中的 Reference）。
Message	區域化錯誤訊息字串。

InvalidCastException(String)

來源:

InvalidCastException.cs

初始化類別的新實例 InvalidCastException 並指定錯誤訊息。

public:
 InvalidCastException(System::String ^ message);

public InvalidCastException(string? message);

new InvalidCastException : string -> InvalidCastException

Public Sub New (message As String)

參數

message

String

描述錯誤的訊息。

備註

此建構子會使用message參數初始Exception.Message化新例外的特性。 內容 message 是為了讓人類理解。 此建構器的呼叫者必須確保此字串已在目前系統文化中本地化。

下表顯示了 的 InvalidCastException初始屬性值。

房產	價值
InnerException	一個空參考（Nothing Visual Basic 中的 Reference）。
Message	錯誤訊息字串。

InvalidCastException(SerializationInfo, StreamingContext)

來源:

InvalidCastException.cs

警告

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

使用串行化數據，初始化 InvalidCastException 類別的新實例。

protected:
 InvalidCastException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected InvalidCastException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new InvalidCastException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> InvalidCastException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

參數

info

SerializationInfo

存放序列化物件資料的物件。

context

StreamingContext

關於來源或目的地的上下文資訊。

屬性

ObsoleteAttribute

備註

此建構子在反序列化過程中被呼叫，以重建透過串流傳輸的例外物件。 欲了解更多資訊，請參閱 XML 與 SOAP 序列化。

另請參閱

• XML 與 SOAP 序列化

InvalidCastException(String, Exception)

來源:

InvalidCastException.cs

初始化類別的新實例 InvalidCastException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。

public:
 InvalidCastException(System::String ^ message, Exception ^ innerException);

public InvalidCastException(string? message, Exception? innerException);

new InvalidCastException : string * Exception -> InvalidCastException

Public Sub New (message As String, innerException As Exception)

參數

message

String

錯誤訊息解釋了例外原因。

innerException

Exception

該例外即為當前例外的原因。 若 innerException 參數不 null為 ，則在處理內部異常的區塊中提出 catch 當前例外。

備註

因先前例外直接拋出的例外，應包含對該屬性中 InnerException 先前例外的參考。 該InnerException屬性回傳與傳入建構子相同的值，或若該InnerException屬性未提供內部例外值，則回傳null。

下表顯示了 的 InvalidCastException初始屬性值。

房產	價值
InnerException	內部例外的參考。
Message	錯誤訊息字串。

另請參閱

• Exception
• 處理與拋出例外

InvalidCastException(String, Int32)

來源:

InvalidCastException.cs

初始化類別的新實例 InvalidCastException ，並以指定的訊息與錯誤代碼。

public:
 InvalidCastException(System::String ^ message, int errorCode);

public InvalidCastException(string? message, int errorCode);

new InvalidCastException : string * int -> InvalidCastException

Public Sub New (message As String, errorCode As Integer)

參數

message

String

說明異常發生原因的訊息。

errorCode

Int32

與例外相關的錯誤碼（HRESULT）值。

備註

此建構子會使用message參數初始Exception.Message化新例外的特性。 內容 message 是為了讓人類理解。 此建構器的呼叫者必須確保此字串已在目前系統文化中本地化。

此建構子提供一個 HRESULT 值，該值可透過類別的保護HResult屬性Exception，讓繼承InvalidCastException者取得。

下表顯示了 的 InvalidCastException初始屬性值。

房產	價值
InnerException	一個空參考（Nothing Visual Basic 中的 Reference）。
Message	錯誤訊息字串。