IOException Constructors

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Initializes a new instance of the IOException class with its message string.

Overloads

IOException()	Initializes a new instance of the IOException class with its message string set to the empty string (""), its HRESULT set to COR_E_IO, and its inner exception set to a null reference.
IOException(String)	Initializes a new instance of the IOException class with its message string set to message, its HRESULT set to COR_E_IO, and its inner exception set to null.
IOException(SerializationInfo, StreamingContext)	Obsolete. Initializes a new instance of the IOException class with the specified serialization and context information.
IOException(String, Exception)	Initializes a new instance of the IOException class with a specified error message and a reference to the inner exception that is the cause of this exception.
IOException(String, Int32)	Initializes a new instance of the IOException class with its message string set to message and its HRESULT user-defined.

IOException()

Source:

IOException.cs

Initializes a new instance of the IOException class with its message string set to the empty string (""), its HRESULT set to COR_E_IO, and its inner exception set to a null reference.

public:
 IOException();

public IOException ();

Public Sub New ()

Remarks

The constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "An I/O error occurred while performing the requested operation." This message takes into account the current system culture.

See also

• File and Stream I/O
• How to: Read Text from a File
• How to: Write Text to a File

IOException(String)

Source:

IOException.cs

Initializes a new instance of the IOException class with its message string set to message, its HRESULT set to COR_E_IO, and its inner exception set to null.

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

public IOException (string? message);

new System.IO.IOException : string -> System.IO.IOException

Public Sub New (message As String)

Parameters

message

String

A String that describes the error. The content of message is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Remarks

The constructor initializes the Message property of the new instance using message.

See also

• File and Stream I/O
• How to: Read Text from a File
• How to: Write Text to a File

IOException(SerializationInfo, StreamingContext)

Source:

IOException.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 IOException class with the specified serialization and context information.

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

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

Parameters

info

SerializationInfo

The data for serializing or deserializing the object.

context

StreamingContext

The source and destination for the object.

Attributes

ObsoleteAttribute

See also

• File and Stream I/O
• How to: Read Text from a File
• How to: Write Text to a File

IOException(String, Exception)

Source:

IOException.cs

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

public:
 IOException(System::String ^ message, Exception ^ innerException);

public IOException (string? message, Exception? innerException);

new System.IO.IOException : string * Exception -> System.IO.IOException

Public 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 IOException.

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

For more information on inner exceptions, see InnerException.

See also

• Exception
• Handling and throwing exceptions in .NET
• File and Stream I/O
• How to: Read Text from a File
• How to: Write Text to a File

IOException(String, Int32)

Source:

IOException.cs

Initializes a new instance of the IOException class with its message string set to message and its HRESULT user-defined.

public:
 IOException(System::String ^ message, int hresult);

public IOException (string? message, int hresult);

new System.IO.IOException : string * int -> System.IO.IOException

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

Parameters

message

String

A String that describes the error. The content of message is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.

hresult

Int32

An integer identifying the error that has occurred.

See also

• File and Stream I/O
• How to: Read Text from a File
• How to: Write Text to a File