ExternalException Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the ExternalException class.
Overloads
| ExternalException() |
Initializes a new instance of the |
| ExternalException(String) |
Initializes a new instance of the |
| ExternalException(SerializationInfo, StreamingContext) |
Obsolete.
Initializes a new instance of the |
| 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()
- Source:
- ExternalException.cs
- Source:
- ExternalException.cs
- Source:
- ExternalException.cs
Initializes a new instance of the ExternalException class with default properties.
public:
ExternalException();public ExternalException ();Public Sub New ()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
ExternalException(String)
- Source:
- ExternalException.cs
- Source:
- ExternalException.cs
- Source:
- ExternalException.cs
Initializes a new instance of the ExternalException class with a specified error message.
public:
ExternalException(System::String ^ message);public ExternalException (string? message);public ExternalException (string message);new System.Runtime.InteropServices.ExternalException : string -> System.Runtime.InteropServices.ExternalExceptionPublic Sub New (message As String)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
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.
protected:
ExternalException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);protected ExternalException (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 ExternalException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);new System.Runtime.InteropServices.ExternalException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Runtime.InteropServices.ExternalException[<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.ExternalException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Runtime.InteropServices.ExternalExceptionProtected Sub New (info As SerializationInfo, context As StreamingContext)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
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.
public:
ExternalException(System::String ^ message, Exception ^ inner);public ExternalException (string? message, Exception? inner);public ExternalException (string message, Exception inner);new System.Runtime.InteropServices.ExternalException : string * Exception -> System.Runtime.InteropServices.ExternalExceptionPublic Sub New (message As String, inner As Exception)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
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.
public:
ExternalException(System::String ^ message, int errorCode);public ExternalException (string? message, int errorCode);public ExternalException (string message, int errorCode);new System.Runtime.InteropServices.ExternalException : string * int -> System.Runtime.InteropServices.ExternalExceptionPublic Sub New (message As String, errorCode As Integer)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
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for