System.IO.IOException 类

方法描述

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

语法定义(C# System.IO.IOException 类 的用法)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class IOException : SystemException

构造函数

构造函数名称 构造函数描述
IOException() 初始化 IOException 类的新实例,使其消息字符串设置为空字符串 (""),其 HRESULT 设置为 COR_E_IO,而其内部异常设置为空引用。
IOException(String) 初始化 IOException 类的新实例,使其消息字符串设置为 message,其 HRESULT 设置为 COR_E_IO,而其内部异常设置为 null。
IOException(SerializationInfo, StreamingContext) 用指定的序列化和上下文信息初始化 IOException 类的新实例。
IOException(String, Exception) 使用指定错误信息和对作为此异常原因的内部异常的引用来初始化 IOException 类的新实例。
IOException(String, Int32) 初始化 IOException 类的新实例,使其消息字符串设置为 message,而其 HRESULT 由用户定义。

成员/方法

方法名称 方法描述
Equals(Object) 确定指定的 Object 是否等于当前的 Object。 (继承自 Object。)
Finalize 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。)
GetBaseException 当在派生类中重写时,返回 Exception,它是一个或多个并发的异常的根源。 (继承自 Exception。)
GetHashCode 用作特定类型的哈希函数。 (继承自 Object。)
GetObjectData 当在派生类中重写时,用关于异常的信息设置 SerializationInfo。 (继承自 Exception。)
GetType 获取当前实例的运行时类型。 (继承自 Exception。) 在 XNA Framework3.0GetType()。 在 GetType()。
MemberwiseClone 创建当前 Object 的浅表副本。 (继承自 Object。)
ToString 创建并返回当前异常的字符串表示形式。 (继承自 Exception。)

提示和注释

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

“基类库”包括下列类型,每种类型都是 IOException 的一个派生类:

DirectoryNotFoundException

EndOfStreamException

FileNotFoundException

FileLoadException

PathTooLongException

在合适的场合,请使用这些类型而不是 IOException。

IOException 使用包含值 0x80131620 的 HRESULT COR_E_IO。

System.IO.IOException 类例子

此代码示例是为 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);
}

继承层次结构

System.Object

System.Exception

System.SystemException

System.IO.IOException

System.IO.DirectoryNotFoundException

System.IO.DriveNotFoundException

System.IO.EndOfStreamException

System.IO.FileLoadException

System.IO.FileNotFoundException

System.IO.PathTooLongException

System.IO.PipeException

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。