FileHandle
структура в Unity.IO.LowLevel.Unsafe
Выполнено в:UnityEngine.CoreModule
Описание
Обращение к асинхронно открытому файлу.
Открытие файла с помощью AsyncReadManager.OpenFileAsync возвращает экземпляр FileHandle. Вы можете использовать этот handler для проверки состояния асинхронной операции открытия.
Используйте AsyncReadManager.Read для чтения данных в файле после завершения операции открытия. Это автоматически дождется завершения операции открытия и передаст ReadHandle WaitingOnJob ReadStatus, пока она выполняется. Если вы используете AsyncReadManager.ReadDeferred вместо этого, вы должны убедиться, что переданный в JobHandle ждет на этом JobHandle для планирования задания чтения после завершения операции открытия.
Всегда вызовите Close на FileHandle после завершения, чтобы избежать утечки памяти и держать файл открытым. Вы должны вызвать close даже если операция открытия не удалась, чтобы удалить FileHandle.
Для записи в файл, используйте стандартный .NET File APIs, такой как System.IO.StreamWriter. Вы должны закрыть этот FileHandle прежде, чем сможете читать или записывать в файл с помощью других APIs. (Если файл открыт кэшем файлов AsyncReadManager, вы можете использовать AsyncReadManager.CloseCachedFileAsync для его закрытия, но не используйте API для закрытия файлов, для которых у вас есть FileHandle, так как они не находятся в кэше.)
Свойства
| Свойство | Описание |
|---|---|
| JobHandle | JobHandle операции открытия асинхронного файла, начатой вызовом AsyncReadManager.OpenFileAsync, который возвратил этот экземпляр FileHandle. |
| Status | Текущий статус этого FileHandle. |