返回一个 Win32 错误代码，指示上次操作的成功或失败。如果前一次操作成功，通常为 0。
例如，如果您尝试使用 FSUtil.OpenFile 打开一个不存在的文件以进行读取，则将返回一个有效的 File 对象 - 但文件本身不会打开。您可以在继续使用 File 对象之前检查 error 是否返回 0。
| | path | *对象:*[**Path**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/path.zh.md) | 返回文件的完整路径名，作为一个 [**Path**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/path.zh.md) 对象。 | | size | *对象:*[**FileSize**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/filesize.zh.md) | 返回一个 [**FileSize**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/filesize.zh.md) 对象，表示此文件的大小（以字节为单位）。 | | tell | *对象:*[**FileSize**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/filesize.zh.md) | 返回一个 [**FileSize**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/filesize.zh.md) 对象，表示此文件内读写光标的当前位置（以字节为单位）。 | | 方法名称 | **参数** | 返回类型 | 描述 | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Close | *无* | *无* |关闭底层文件句柄。在此调用之后，File 对象仍然有效，但它不能再读取或写入数据。
如果您想使用 SetAttr 方法修改您创建的文件的属性，您可能想要先调用 Close，否则文件系统将在您想要设置或不想要设置的情况下在文件上设置 A（压缩包）属性。
如果您想删除文件，您可能还想手动关闭文件，因为一些脚本语言（例如 JScript）具有延迟垃圾回收，否则可能会比您预期的更长时间保持文件句柄打开。
| | Read |<blob:target>
\
int 或
对象:Blob
从文件读取数据。如果您提供一个 target Blob 作为第一个参数，数据将存储在该 Blob 中。否则，将自动创建一个 Blob。
可选的 size 参数指定要读取的字节数 - 默认行为是读取文件的剩余内容。
每次调用最多可以读取 1 GB（1073741824 字节），无论是否指定或隐式指定大小。要读取更大的文件，您必须多次调用 Read。
如果您提供一个 Blob，则返回值表示从文件成功读取的字节数。如果没有提供 Blob，则返回值是自动创建的 Blob - 您可以使用它的 size 属性来发现读取的字节数。
如果 Read 返回零（或空 Blob），您可以使用 error 属性测试是否出现错误，或者文件是否 simply had no more data.
\
\
移动此文件内的读写光标。delta 参数指定要移动的字节数 - 如何解释它取决于可选的 method 参数：
b - 相对于文件开头移动
e - 相对于文件结尾移动
c - 相对于当前位置移动（这是默认方法）
返回值是一个 FileSize 对象，指示新的光标位置。
| | SetAttr |对象:FileAttr
或 \
修改此文件的属性。您可以传递一个表示要设置的属性的字符串，或者传递一个 FileAttr 对象。使用字符串时，有效的属性为：
a - 压缩包
c - 压缩
e - 加密
h - 隐藏
n - 正常
r - 只读
s - 系统
p - 固定
i - 非内容索引
请注意，c 和 e 属性不能同时设置。
当您传递字符串时，您还可以使用 + 和 - 来打开或关闭某些属性，而不会影响其它属性。例如，SetAttr("-r") 将关闭只读属性。
返回值为 True，如果操作成功。
| | SetTime |\
\
\
修改一个或多个文件的时间戳。create 和 access 参数是可选的。如果您希望指定一个时间戳没有变化，请指定 0。
时间戳指定为本地时间 - 使用 SetTimeUTC 将它们指定为 UTC。
返回值为 True，如果操作成功。
| | SetTimeUTC |\
\
\
修改一个或多个文件的时间戳。create 和 access 参数是可选的。如果您希望指定一个时间戳没有变化，请指定 0。
时间戳指定为 UTC 时间 - 使用 SetTime 将它们指定为本地时间。
返回值为 True，如果操作成功。
| | Truncate | *无* | *bool* |在写入光标的当前位置截断文件。您可以将此与 Seek 方法结合使用，以在磁盘上预分配文件的空间，从而提高性能（即，寻求文件的最终大小，在该点截断，然后返回到起点并写入数据）。
返回值为 True，如果操作成功。
| | Write |<blob:source> 或 \
\
\
将指定 Blob（或数组）或 string 中的数据写入文件。
默认情况下，将写入 Blob 的所有内容，但您可以使用可选的 from 参数指定源字节偏移量，使用 size 参数指定要写入的字节数。
每次调用最多可以写入 1 GB（1073741824 字节），无论是否指定或隐式指定大小。要写入更大的数据量，您必须多次调用 Write。
如果您提供 string 而不是 Blob，则该字符串将自动编码为 UTF-8。
返回值表示成功写入文件的字节数。
如果 Write 返回零，您可以使用 error 属性测试是否出现错误，或者是否 simply had no data to write（例如，指定的 Blob 为空）。