Unity 6.3
0 онлайн 63 гостей 3 в системе
Вход

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, так как они не находятся в кэше.)

Свойства

Свойство Описание
JobHandleJobHandle операции открытия асинхронного файла, начатой вызовом AsyncReadManager.OpenFileAsync, который возвратил этот экземпляр FileHandle.
StatusТекущий статус этого FileHandle.

Открытые методы

Метод Описание
CloseАсинхронно закрывает файл, на который ссылается этот экземпляр FileHandle, и удаляет экземпляр FileHandle.
IsValidСообщает, является ли экземпляр FileHandle действительным.