版本: Unity 6 (6000.0)
语言英语
  • C#

FileHandle

Unity.IO.LowLevel.Unsafe 中的结构体

/

实现于:UnityEngine.CoreModule

建议更改

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交内容,但我们确实阅读了用户提出的每个建议更改,并在适用的情况下进行更新。

关闭

提交失败

由于某种原因,您的建议更改无法提交。请<a>稍后再试</a>。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

描述

异步打开文件的句柄。

使用 AsyncReadManager.OpenFileAsync 打开文件将返回一个 FileHandle 实例。您可以使用此句柄检查异步打开操作的状态。

打开操作完成后,使用 AsyncReadManager.Read 读取文件中的数据。这将自动等待打开操作完成,并在执行此操作时为 ReadHandle 提供一个 WaitingOnJob ReadStatus。如果改为使用 AsyncReadManager.ReadDeferred,则应确保传递的 JobHandle 等待此 JobHandle,以便在打开操作完成后调度读取作业。

完成后,始终在 FileHandle 上调用 Close 以避免内存泄漏并保持文件打开。即使打开操作失败,也必须调用关闭以释放 FileHandle。

要写入文件,请使用标准 .NET 文件 API,例如 System.IO.StreamWriter。您必须先关闭此 FileHandle,然后才能使用其他 API 读取或写入文件。(如果文件由 AsyncReadManager 的文件缓存保持打开状态,则可以使用 AsyncReadManager.CloseCachedFileAsync 关闭它,但不要使用该 API 关闭您拥有 FileHandle 的文件,因为这些文件不在缓存中。)

属性

JobHandle由调用返回此 FileHandle 实例的 AsyncReadManager.OpenFileAsync 启动的异步文件打开操作的 JobHandle。
状态此 FileHandle 的当前状态。

公共方法

关闭异步关闭此 FileHandle 引用的文件并释放 FileHandle 实例。
IsValid报告此 FileHandle 实例是否有效。