IOException 类

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

Source:

IOException.cs

发生 I/O 错误时引发的异常。

public ref class IOException : SystemException

public class IOException : SystemException

type IOException = class
    inherit SystemException

Public Class IOException
Inherits SystemException

继承

Object

Exception

SystemException

IOException

派生

System.IO.DirectoryNotFoundException

System.IO.DriveNotFoundException

System.IO.EndOfStreamException

System.IO.FileLoadException

System.IO.FileNotFoundException

System.IO.PathTooLongException

System.IO.PipeException

System.Net.Http.HttpIOException

System.Net.Quic.QuicException

示例

此代码示例是为 方法提供的更大示例的 FileStream.Lock 一部分。

// Catch the IOException generated if the 
// specified part of the file is locked.
catch ( IOException^ e ) 
{
   Console::WriteLine( "{0}: The write operation could not "
   "be performed because the specified "
   "part of the file is locked.", e->GetType()->Name );
}

// Catch the IOException generated if the
// specified part of the file is locked.
catch(IOException e)
{
    Console.WriteLine(
        "{0}: The write operation could not " +
        "be performed because the specified " +
        "part of the file is locked.",
        e.GetType().Name);
}

' Catch the IOException generated if the 
' specified part of the file is locked.
Catch ex As IOException
    Console.WriteLine( _
        "{0}: The write operation could " & _
        "not be performed because the " & _
        "specified part of the file is " & _
        "locked.", ex.GetType().Name)
End Try

注解

IOException 是在使用流、文件和目录访问信息时引发的异常的基类。

基类库包含以下类型，每种类型都是 的 IOException 派生类：

• DirectoryNotFoundException

• EndOfStreamException

• FileNotFoundException

• FileLoadException

• PathTooLongException

在适当的情况下，请使用这些类型而不是 IOException。

IOException 使用值0x80131620的 HRESULT COR_E_IO。

构造函数

IOException()	初始化 IOException 类的新实例，其中将消息字符串设置为空字符串 ("")，将其 HRESULT 设置为 COR_E_IO，并且将其内部异常设置为空引用。
IOException(SerializationInfo, StreamingContext)	已过时. 使用指定的序列化和上下文信息初始化 IOException 类的新实例。
IOException(String)	初始化 IOException 类的新实例，其中将消息字符串设置为 message，将其 HRESULT 设置为 COR_E_IO，并且将其内部异常设置为 null。
IOException(String, Exception)	使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 IOException 类的新实例。
IOException(String, Int32)	初始化 IOException 类的新实例，将其消息字符串设置为 message 并将其 HRESULT 设置为用户定义的。

属性

Data	获取键/值对的集合，这些键/值对提供有关该异常的其他用户定义信息。 (继承自 Exception)
HelpLink	获取或设置指向与此异常关联的帮助文件链接。 (继承自 Exception)
HResult	获取或设置 HRESULT（一个分配给特定异常的编码数字值）。 (继承自 Exception)
InnerException	获取导致当前异常的 Exception 实例。 (继承自 Exception)
Message	获取描述当前异常的消息。 (继承自 Exception)
Source	获取或设置导致错误的应用程序或对象的名称。 (继承自 Exception)
StackTrace	获取调用堆栈上的即时框架字符串表示形式。 (继承自 Exception)
TargetSite	获取引发当前异常的方法。 (继承自 Exception)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetBaseException()	当在派生类中重写时，返回 Exception，它是一个或多个并发的异常的根本原因。 (继承自 Exception)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)	已过时. 当在派生类中重写时，用关于异常的信息设置 SerializationInfo。 (继承自 Exception)
GetType()	获取当前实例的运行时类型。 (继承自 Exception)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	创建并返回当前异常的字符串表示形式。 (继承自 Exception)

事件

SerializeObjectState

已过时. 当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。 (继承自 Exception)

另请参阅

• Exception
• 在 .NET 中处理和引发异常
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件