Dapper 不直接支持 SQL Server 的 FILESTREAM 功能,需配合 ADO.NET 使用 SqlFileStream 或 varbinary(max) 参数完成读写;它仅负责参数传递与结果映射,FILESTREAM 的流操作、事务控制和路径管理须手动实现。

Dapper 本身不直接支持 SQL Server 的 FILESTREAM 功能,但它可以配合 ADO.NET 原生能力完成 FileStream 数据的读写操作。关键在于:Dapper 负责参数传递和结果映射,而 FILESTREAM 的二进制流处理需通过 SqlFileStream 或常规 varbinary(max) 参数方式实现。
理解 FILESTREAM 在 Dapper 中的角色定位
SQL Server 的 FILESTREAM 是将大文件(如图片、文档)存储在 NTFS 文件系统中,同时在数据库中保留指向该文件的指针(uniqueidentifier)。Dapper 不提供对 SqlFileStream 类的封装,也不自动识别 varbinary(max) FILESTREAM 列——它只把列当作普通二进制字段处理。因此你需要手动控制流的打开、读写和关闭逻辑。
- 插入/更新时,若想启用 FILESTREAM 存储,必须确保表已启用 FILESTREAM,并且对应列为
varbinary(max) FILESTREAM - Dapper 可以传入
byte[]或Stream(需配合自定义IDbCommand设置)作为参数,但底层仍依赖 ADO.NET 的SqlParameter配置 - 查询 FILESTREAM 列时,Dapper 默认返回
byte[];若数据很大,建议改用SqlFileStream按需读取,避免内存爆炸
插入 FILESTREAM 数据(带事务与路径获取)
插入 FILESTREAM 数据需要两步:先插入一条记录获取 FILESTREAM 路径(即 PathName()),再用该路径创建 SqlFileStream 写入内容。Dapper 可用于执行这两步 SQL,但流操作要自己写。
- 第一步:用 Dapper 插入空记录(FILESTREAM 列为
0x或NULL),并返回ROWGUID或主键 - 第二步:调用
SELECT [FileColumn].PathName(), GET_FILESTREAM_TRANSACTION_CONTEXT()获取路径和上下文 - 第三步:在同一个事务中,用
new SqlFileStream(path, context, FileAccess.Write)写入原始字节流
注意:整个过程必须在显式开启的 SqlTransaction 中进行,且 Dapper 的 Execute / QuerySingle 方法需传入该事务对象。
大小仅1兆左右 ,足够轻便的商城系统; 易部署,上传空间即可用,安全,稳定; 容易操作,登陆后台就可设置装饰网站; 并且使用异步技术处理网站数据,表现更具美感。 前台呈现页面,兼容主流浏览器,DIV+CSS页面设计; 如果您有一定的网页设计基础,还可以进行简易的样式修改,二次开发, 发布新样式,调整网站结构,只需修改css目录中的css.css文件即可。 商城网站完全独立,网站源码随时可供您下载
读取 FILESTREAM 数据(避免全量加载)
直接用 Dapper 查询 FILESTREAM 列会把整个文件加载进内存(如 conn.QuerySingle),不适合大文件。推荐方式是只查出路径和上下文,再用 SqlFileStream 流式读取。
- 用 Dapper 执行
SELECT FileData.PathName(), GET_FILESTREAM_TRANSACTION_CONTEXT()得到流信息 - 在
SqlTransaction内创建SqlFileStream,然后用CopyTo或分块Read输出到响应流、文件或内存缓冲区 - 务必在使用后调用
stream.Close(),否则 SQL Server 可能锁住文件句柄
替代方案:用 varbinary(max) 绕过 FILESTREAM(适合中小文件)
如果文件普遍小于 1–2 MB,可放弃 FILESTREAM,直接用标准 varbinary(max) 列 + Dapper 简化操作:
- 插入:
conn.Execute("INSERT INTO Docs (Name, Content) VALUES (@name, @content)", new { name = "a.pdf", content = File.ReadAllBytes(path) }) - 读取:
byte[] data = conn.QuerySingle("SELECT Content FROM Docs WHERE Id = @id", new { id = 123 }) - 优点是零额外依赖、事务透明、Dapper 完全兼容;缺点是数据库体积增长快、备份变重
基本上就这些。Dapper 不是 FILESTREAM 的“开关”,而是你操作数据库的轻量管道——FILESTREAM 的复杂性仍在 ADO.NET 层,Dapper 只帮你更干净地拼 SQL 和传参。









