SuperAPI AI 工具集

dotnet-file-io

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 .NET 应用提供文件 I/O 模式参考,涵盖 FileStream、RandomAccess、FileSystemWatcher、MemoryMappedFile、路径处理与错误处理。

主要能力:FileStream 构造与异步标志(useAsync: true 或 FileOptions.Asynchronous,否则 ReadAsync/WriteAsync 会在线程池上模拟同步 I/O);FileStreamOptions(.NET 6+,含 PreallocationSize);RandomAccess 静态偏移读写,无内部位置状态,可多线程并发访问不同偏移,支持 scatter/gather;File 便捷方法(ReadAllTextAsync、ReadAllLinesAsync、ReadLinesAsync 等);FileSystemWatcher 事件处理与去抖,InternalBufferSize 最大 64 KB,需处理 InternalBufferOverflowException;MemoryMappedFile 用于大文件随机访问与 IPC 共享内存;路径安全(Path.Combine 在第二参数为根路径时会丢弃基路径,应改用 Path.Join,并做路径遍历校验);安全临时文件(用 Path.GetRandomFileName 替代 Path.GetTempFileName);跨平台差异(大小写、UnixFileMode、文件锁);IOException 层次与 HResult 判断;缓冲区大小建议。

使用方式:按场景选择 API——并发不同偏移用 RandomAccess,顺序流式用 FileStream,小文件用 File 便捷方法,大文件或 IPC 用 MemoryMappedFile。示例代码见资料原文。

适用场景:.NET 桌面、服务端与跨平台应用中的文件读写、目录监控、大文件处理与进程间共享内存。

限制:不覆盖 PipeReader/PipeWriter 与网络 I/O、async/await 基础、Span/Memory/ArrayPool 深入模式、JSON/Protobuf 序列化、内存映射后备数组的 GC 影响,这些由其他技能处理。具体版本支持与平台行为以资料所述为准。