简介面向C# WinForms开发者的局域网文件上传实战工程基于VS2010搭建。它针对把本地文件写入服务器共享文件夹这一内网常见需求演示了完整链路用OpenFileDialog选文件通过UNC路径配合NetworkCredential建立连接用FileStream读写并借BackgroundWorker异步回报进度最后做异常捕获和文件类型、大小校验。压缩包共23个文件约36KB以6个.cs源码文件为核心同时包含.sln与.csproj工程配置、exe程序、resx与resources资源以及AssemblyInfo等可直接打开解决方案对照阅读。已有1429人学习。代码结构简洁便于理解共享目录访问权限、流式传输与UI进度更新的配合方式也可作为内网文件传输小工具的原型参考。1. WinForms 上传文件到共享文件夹一行 File.Copy 撑不住的真实场景接到「WinForms 上传文件到共享文件夹」这个需求时很多人的第一反应是File.Copy一行搞定。真到现场就不是这么回事了工控机跑在本地账号下共享目录在另一台机器上凭据不通直接甩一个 1326扫描件动辄几十兆进度条一卡操作员以为程序死了直接点叉传到一半网络抖一下共享目录里留下一堆半截 PDF下游系统照着读全报错。这套东西要解决的就是「文件上传到服务器」里最土但最难绕开的那一段不装服务端、不走 HTTP把本地文件可靠地落到 UNC 共享目录里还要能看进度、能重试、能取消、换台机器照样跑。适合手上正在写内部工具、被现场环境反复折磨过的 WinForms 开发者。2. 工程结构与技术选型三层拆分让上传逻辑和窗体彻底解耦先把工程骨架定下来后面所有讨论才有落点。这里最容易犯的错是把上传逻辑直接写进MainForm.cs的按钮事件里初期跑得飞快等到要加断点续传、要换认证方式、要在另一个窗体复用同一套逻辑时就会发现连单元测试都没法写——窗体依赖SynchronizationContext脱离消息循环一跑就抛异常。2.1 目录结构把上传内核从窗体里抽出来的理由我一般会拆成三个项目UI 只负责画界面和收事件Core 放纯逻辑且不引用System.Windows.FormsInfrastructure 放日志、配置、重试这些横切关注点。这样 Core 可以在控制台里跑测试也可以被 WPF 或 Windows 服务复用。FileUploader/ ├─ FileUploader.sln ├─ src/ │ ├─ FileUploader.UI/ WinForms 宿主 │ │ ├─ Forms/MainForm.cs 只做控件编排与事件转发 │ │ ├─ Forms/MainForm.Designer.cs │ │ └─ Program.cs │ ├─ FileUploader.Core/ 与 UI 无关的上传内核 │ │ ├─ IFileUploader.cs 上传契约 │ │ ├─ SmbFileUploader.cs UNC 直写实现 │ │ ├─ UploadRequest.cs 一次上传的入参 │ │ ├─ UploadProgress.cs 进度快照 │ │ ├─ UploadQueue.cs 并发调度与取消 │ │ ├─ NameResolver.cs 重名与非法字符处理 │ │ └─ UncPath.cs UNC 路径规范化 │ └─ FileUploader.Infrastructure/ │ ├─ AppSettings.cs appsettings.json 绑定 │ ├─ FileLogger.cs 按天滚动的文本日志 │ ├─ RetryPolicy.cs 指数退避重试 │ └─ NetworkSession.cs 凭据与会话第 4 章展开 └─ tests/ └─ FileUploader.Core.Tests/关键点在于IFileUploader这层抽象。它只有三个参数请求、进度回调、取消令牌。后面就算客户要求改成走 HTTP 接口上传到对象存储也只是多一个HttpFileUploader实现UI 层一行都不用动。public interface IFileUploader { // 返回结果里带上最终落地路径和耗时方便 UI 展示与日志留痕 TaskUploadResult UploadAsync(UploadRequest request, IProgressUploadProgress progress, CancellationToken ct); }UploadRequest里我倾向放四个字段LocalPath本地源文件绝对路径、TargetRoot\\server\share这一层、SubFolder可空按日期分目录时用、Overwrite是否允许覆盖。把「根目录」和「子目录」分开存是因为根目录通常来自配置文件而子目录来自业务规则混成一个字符串之后做路径拼接很容易多一个或少一个反斜杠这种低级错误排查起来能耗掉半天。2.2 技术选型UNC 直写、映射盘符、中转接口怎么选把文件传到共享目录至少有四条路选错了后面全是返工。这张表是我踩过几轮之后留下的判断依据方式适用场景优点隐藏坑UNC 直写\\server\share内网、客户端和服务端同域或可互认凭据零服务端成本吞吐高支持大文件凭据绑定进程身份跨机器容易 1326映射盘符Z:\临时脚本、运维手工操作路径短调试直观盘符被占用、会话隔离、服务里基本不可用HTTP 中转接口需要审计、限流、多端一致权限收口在服务端客户端不碰共享要写服务端大文件得做分片SFTP/FTP跨网段、跨系统协议通用多一套账号体系WinForms 端要引第三方库内部工具、客户端只有几十台、共享目录本来就在内网文件服务器上那 UNC 直写是最划算的。它的根本限制是「用谁的身份去连」——这一条决定了第 4 章要花那么多篇幅讲凭据。映射盘符这条路我不建议用在正式产品里原因很实在net use映射出来的盘符是跟着登录会话走的同一台机器上另一个用户登录上来根本看不见做成 Windows 服务更是直接失效。开发机上测得好好的装成服务就找不到路径血泪经验。2.3 跑起来的最小闭环配置项、运行环境与第一次连通性验证工程是 .NET 6 之后的 WinFormscsproj 里两个关键属性不能少少了会在非 Windows 目标框架上报错PropertyGroup TargetFrameworknet8.0-windows/TargetFramework UseWindowsFormstrue/UseWindowsForms Nullableenable/Nullable /PropertyGroup配本文还有配套的精品资源点击获取