SerializationException Constructors
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 SerializationException class.
| SerializationException() |
Initializes a new instance of the SerializationException class with default properties. |
| SerializationException(String) |
Initializes a new instance of the SerializationException class with a specified message. |
| SerializationException(SerializationInfo, StreamingContext) |
Obsolete.
Initializes a new instance of the SerializationException class from serialized data. |
| SerializationException(String, Exception) |
Initializes a new instance of the SerializationException class with a specified error message and a reference to the inner exception that is the cause of this exception. |
- Source:
- SerializationException.cs
- Source:
- SerializationException.cs
- Source:
- SerializationException.cs
Initializes a new instance of the SerializationException class with default properties.
public:
SerializationException();public SerializationException();Public Sub New ()Remarks
SerializationException inherits from the SystemException class. The following table shows initial property values for an instance of SerializationException initialized with the current constructor.
| Property | Condition |
|---|---|
| InnerException | null |
| Message | Localized error message for SerializationException. |
Applies to
.NET 10 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, 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 |
| UWP | 10.0 |
- Source:
- SerializationException.cs
- Source:
- SerializationException.cs
- Source:
- SerializationException.cs
Initializes a new instance of the SerializationException class with a specified message.
public:
SerializationException(System::String ^ message);public SerializationException(string message);public SerializationException(string? message);new System.Runtime.Serialization.SerializationException : string -> System.Runtime.Serialization.SerializationExceptionPublic Sub New (message As String)Parameters
- message
- String
Indicates the reason why the exception occurred.
Remarks
SerializationException inherits from the SystemException class. The following table shows initial property values for an instance of SerializationException initialized with the current constructor.
| Property | Condition |
|---|---|
| InnerException | null |
| Message | The message string. |
Applies to
.NET 10 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, 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 |
| UWP | 10.0 |
- Source:
- SerializationException.cs
- Source:
- SerializationException.cs
- Source:
- SerializationException.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 SerializationException class from serialized data.
protected:
SerializationException(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 SerializationException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);protected SerializationException(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.Serialization.SerializationException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Runtime.Serialization.SerializationExceptionnew System.Runtime.Serialization.SerializationException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Runtime.Serialization.SerializationExceptionProtected Sub New (info As SerializationInfo, context As StreamingContext)Parameters
- info
- SerializationInfo
The serialization information object holding the serialized object data in the name-value form.
- context
- StreamingContext
The contextual information about the source or destination of the exception.
- Attributes
Exceptions
The info parameter is null.
Remarks
The current constructor is called during deserialization to reconstitute the exception object transmitted over a stream. (For more information on serialization see XML and SOAP Serialization.)
Applies to
.NET 10 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, 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 |
- Source:
- SerializationException.cs
- Source:
- SerializationException.cs
- Source:
- SerializationException.cs
Initializes a new instance of the SerializationException class with a specified error message and a reference to the inner exception that is the cause of this exception.
public:
SerializationException(System::String ^ message, Exception ^ innerException);public SerializationException(string message, Exception innerException);public SerializationException(string? message, Exception? innerException);new System.Runtime.Serialization.SerializationException : string * Exception -> System.Runtime.Serialization.SerializationExceptionPublic Sub New (message As String, innerException As Exception)Parameters
- message
- String
The error message that explains the reason for the exception.
- innerException
- Exception
The exception that is the cause of the current exception. If the innerException 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 SerializationException.
| Property | Value |
|---|---|
| InnerException | The inner exception reference. |
| Message | The error message string. |
See also
Applies to
.NET 10 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, 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 |
| UWP | 10.0 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: