COMException Constructors

Definition

Initializes a new instance of the COMException class.

Overloads

COMException()

Initializes a new instance of the COMException class with default values.

COMException(String)

Initializes a new instance of the COMException class with a specified message.

COMException(SerializationInfo, StreamingContext)
Obsolete.

Initializes a new instance of the COMException class from serialization data.

COMException(String, Exception)

Initializes a new instance of the COMException class with a specified error message and a reference to the inner exception that is the cause of this exception.

COMException(String, Int32)

Initializes a new instance of the COMException class with a specified message and error code.

COMException()

Source:
COMException.cs
Source:
COMException.cs
Source:
COMException.cs

Initializes a new instance of the COMException class with default values.

C#
public COMException();

Remarks

COMException inherits from ExternalException. The following table shows how this constructor sets the properties of the Exception object.

Property Value
InnerException null.
Message A localized error message string.

Applies to

.NET 9 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

COMException(String)

Source:
COMException.cs
Source:
COMException.cs
Source:
COMException.cs

Initializes a new instance of the COMException class with a specified message.

C#
public COMException(string message);
C#
public COMException(string? message);

Parameters

message
String

The message that indicates the reason for the exception.

Remarks

COMException inherits from ExternalException. The following table shows how this constructor sets the properties of the Exception object.

Property Value
InnerException null
Message message

Applies to

.NET 9 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

COMException(SerializationInfo, StreamingContext)

Source:
COMException.cs
Source:
COMException.cs
Source:
COMException.cs

Caution

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

Initializes a new instance of the COMException class from serialization data.

C#
protected COMException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
C#
[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);

Parameters

info
SerializationInfo

The SerializationInfo object that holds the serialized object data.

context
StreamingContext

The StreamingContext object that supplies the contextual information about the source or destination.

Attributes

Exceptions

info is null.

Remarks

This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see XML and SOAP Serialization.

COMException inherits from ExternalException.

See also

Applies to

.NET 9 and other versions
Product Versions (Obsolete)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

COMException(String, Exception)

Source:
COMException.cs
Source:
COMException.cs
Source:
COMException.cs

Initializes a new instance of the COMException class with a specified error message and a reference to the inner exception that is the cause of this exception.

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

Parameters

message
String

The error message that explains the reason for the exception.

inner
Exception

The exception that is the cause of the current exception. If the inner parameter is not null, the current exception is raised in a catch block that handles the inner exception.

Remarks

An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

The following table shows how this constructor sets the properties of the Exception object.

Property Value
InnerException The inner exception reference.
Message The error message string.

See also

Applies to

.NET 9 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

COMException(String, Int32)

Source:
COMException.cs
Source:
COMException.cs
Source:
COMException.cs

Initializes a new instance of the COMException class with a specified message and error code.

C#
public COMException(string message, int errorCode);
C#
public COMException(string? message, int errorCode);

Parameters

message
String

The message that indicates the reason the exception occurred.

errorCode
Int32

The error code (HRESULT) value associated with this exception.

Remarks

This COMException constructor sets the base message with the error code.

COMException inherits from ExternalException. The following table shows how this constructor sets the properties of the Exception object.

Property Value
InnerException null
Message message

Applies to

.NET 9 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0