FileStream 构造函数 (String, FileMode, FileAccess)
2013/3/11
使用指定的路径、创建模式和读/写权限初始化 FileStream 类的新实例。
程序集: mscorlib(位于 mscorlib.dll 中)
参数
- path
- 类型: System.String
当前 FileStream 对象将封装的文件的相对路径或绝对路径。
- mode
- 类型: System.IO.FileMode
FileMode 常数,确定如何打开或创建文件。
- access
- 类型: System.IO.FileAccess
FileAccess 常数,它确定 FileStream 对象访问文件的方式。这将获取 FileStream 对象的 CanRead 和 CanWrite 属性。如果 path 指定磁盘文件,则 CanSeek 为 true。
| 异常 | 条件 |
|---|---|
| ArgumentNullException | path 为 null。 |
| ArgumentException | path 为空字符串 (""),只包含空格,或者包含一个或多个无效字符。 - 或 - path 引用一个非文件设备,如 NTFS 环境中的“con:”、“com1:”、“lpt1:”等。 |
| NotSupportedException | path 引用一个非文件设备,如非 NTFS 环境中的“con:”、“com1:”、“lpt1:”等。 |
| ArgumentException | path 为空字符串 (""),只包含空格,或者包含一个或多个无效字符。 |
| FileNotFoundException | 找不到文件,比如当 mode 是 FileMode.Truncate 或 FileMode.Open 而 path 指定的文件不存在时。文件必须已经以这些模式存在。 |
| IOException | 发生 I/O 错误,比如指定 FileMode.CreateNew 而 path 指定的文件已存在。 - 或 - 流已关闭。 |
| SecurityException | 调用方没有所要求的权限。 |
| DirectoryNotFoundException | 指定的路径无效,比如在未映射的驱动器上。 |
| UnauthorizedAccessException | 对于指定的 path 操作系统不允许所请求的 access,比如当 access 是 Write 或 ReadWrite 而文件或目录设置为只读访问时。 |
| PathTooLongException | 指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。 |
| ArgumentOutOfRangeException | mode 包含无效值。 |
版本说明
Windows Phone
此成员具有 SecurityCriticalAttribute 特性。此特性将此成员限制为内部使用。使用此成员的应用程序代码引发 MethodAccessException。