COMException 建構函式

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

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

多載

COMException()	使用預設值，初始化 COMException 類別的新執行個體。
COMException(String)	使用指定的訊息，初始化 COMException 類別的新執行個體。
COMException(SerializationInfo, StreamingContext)	已淘汰. 從序列化 (Serialization) 資料，初始化 COMException 類別的新執行個體。
COMException(String, Exception)	使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考，初始化 COMException 類別的新執行個體。
COMException(String, Int32)	使用指定的訊息和錯誤碼，初始化 COMException 類別的新執行個體。

COMException()

來源:

COMException.cs

使用預設值，初始化 COMException 類別的新執行個體。

public:
 COMException();

public COMException ();

Public Sub New ()

備註

COMException 繼承自 ExternalException。 下表顯示此建構函式如何設定 物件的屬性 Exception 。

屬性	值
InnerException	null.
Message	本地化的錯誤訊息字串。

COMException(String)

來源:

COMException.cs

使用指定的訊息，初始化 COMException 類別的新執行個體。

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

public COMException (string? message);

new System.Runtime.InteropServices.COMException : string -> System.Runtime.InteropServices.COMException

Public Sub New (message As String)

參數

message

String

訊息，表示例外狀況的原因。

備註

COMException 繼承自 ExternalException。 下表顯示此建構函式如何設定 物件的屬性 Exception 。

屬性	值
InnerException	null
Message	message

COMException(SerializationInfo, StreamingContext)

來源:

COMException.cs

警告

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

從序列化 (Serialization) 資料，初始化 COMException 類別的新執行個體。

protected:
 COMException(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 COMException (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 System.Runtime.InteropServices.COMException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Runtime.InteropServices.COMException

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

參數

info

SerializationInfo

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

context

StreamingContext

提供關於來源或目的端內容資訊的 StreamingContext 物件。

屬性

ObsoleteAttribute

例外狀況

ArgumentNullException

info 為 null。

備註

這個建構函式是在還原序列化期間呼叫，以便重新組成透過資料流傳輸的例外狀況物件。 如需詳細資訊，請參閱 < XML 和 SOAP 序列化。

COMException 繼承自 ExternalException。

另請參閱

• ExternalException

COMException(String, Exception)

來源:

COMException.cs

使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考，初始化 COMException 類別的新執行個體。

public:
 COMException(System::String ^ message, Exception ^ inner);

public COMException (string? message, Exception? inner);

new System.Runtime.InteropServices.COMException : string * Exception -> System.Runtime.InteropServices.COMException

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

參數

message

String

解釋例外狀況原因的錯誤訊息。

inner

Exception

做為目前例外狀況發生原因的例外狀況。 如果 inner 參數不是 null，則目前的例外狀況會在處理內部例外的 catch 區塊中引發。

備註

被擲回以做為前一個例外狀況直接結果的例外狀況，應該在 InnerException 屬性中包含對前一個例外狀況的參考。 InnerException 屬性傳回的值會與傳入建構函式的值相同，或傳回 null (如果 InnerException 屬性未提供內部例外狀況值給建構函式)。

下表顯示此建構函式如何設定 物件的屬性 Exception 。

屬性	值
InnerException	內部例外狀況參考。
Message	錯誤訊息字串。

另請參閱

• Exception
• 在 .NET 中處理和擲回例外狀況

COMException(String, Int32)

來源:

COMException.cs

使用指定的訊息和錯誤碼，初始化 COMException 類別的新執行個體。

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

public COMException (string? message, int errorCode);

new System.Runtime.InteropServices.COMException : string * int -> System.Runtime.InteropServices.COMException

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

參數

message

String

訊息，指出例外狀況發生的原因。

errorCode

Int32

與這個例外狀況相關的錯誤碼 (HRESULT) 值。

備註

這個 COMException 建構函式會使用錯誤碼來設定基底訊息。

COMException 繼承自 ExternalException。 下表顯示此建構函式如何設定 物件的屬性 Exception 。

屬性	值
InnerException	null
Message	message