ExternalException Constructors

Definition

Initializes a new instance of the ExternalException class.

Overloads

ExternalException()

Initializes a new instance of the ExternalException class with default properties.

ExternalException(String)

Initializes a new instance of the ExternalException class with a specified error message.

ExternalException(SerializationInfo, StreamingContext)
Obsolete.

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

ExternalException(String, Exception)

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

ExternalException(String, Int32)

Initializes a new instance of the ExternalException class with a specified error message and the HRESULT of the error.

ExternalException()

Source:
ExternalException.cs
Source:
ExternalException.cs
Source:
ExternalException.cs

Initializes a new instance of the ExternalException class with default properties.

C#
public ExternalException();

Remarks

The following table shows the initial property values for an instance of ExternalException.

Property Value
InnerException A null reference (Nothing in Visual Basic).
Message A localized error message string.

Applies to

.NET 10 och andra versioner
Produkt Versioner
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.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

ExternalException(String)

Source:
ExternalException.cs
Source:
ExternalException.cs
Source:
ExternalException.cs

Initializes a new instance of the ExternalException class with a specified error message.

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

Parameters

message
String

The error message that specifies the reason for the exception.

Remarks

The following table shows the initial property values for an instance of ExternalException.

Property Value
InnerException A null reference (Nothing in Visual Basic).
Message The error message string.

Applies to

.NET 10 och andra versioner
Produkt Versioner
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.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

ExternalException(SerializationInfo, StreamingContext)

Source:
ExternalException.cs
Source:
ExternalException.cs
Source:
ExternalException.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 ExternalException class from serialization data.

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

Parameters

info
SerializationInfo

The object that holds the serialized object data.

context
StreamingContext

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.

Applies to

.NET 10 och andra versioner
Produkt Versioner (Föråldrad)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9, 10)
.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

ExternalException(String, Exception)

Source:
ExternalException.cs
Source:
ExternalException.cs
Source:
ExternalException.cs

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

C#
public ExternalException(string? message, Exception? inner);
C#
public ExternalException(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 the initial property values for an instance of ExternalException.

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

See also

Applies to

.NET 10 och andra versioner
Produkt Versioner
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.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

ExternalException(String, Int32)

Source:
ExternalException.cs
Source:
ExternalException.cs
Source:
ExternalException.cs

Initializes a new instance of the ExternalException class with a specified error message and the HRESULT of the error.

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

Parameters

message
String

The error message that specifies the reason for the exception.

errorCode
Int32

The HRESULT of the error.

Remarks

The following table shows the initial property values for an instance of ExternalException.

Property Value
ErrorCode The HRESULT of the error.
InnerException A null reference (Nothing in Visual Basic).
Message The error message string.

Applies to

.NET 10 och andra versioner
Produkt Versioner
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.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