尧图网站建设 
简介这份资源面向C# Winform开发者尤其是需要实现局域网文件传输功能的中级学习者提供了一套将本地文件上传至服务器共享文件夹的完整解决方案。项目基于VS2010环境围绕文件选择、网络凭据连接、文件流读写、进度显示、异常处理与安全校验等环节展开帮助读者理解共享文件夹访问与网络编程的配合方式。压缩包共23个文件约36KB以cs源码、exe可执行文件、pdb调试符号、resx与resources资源文件、csproj工程文件及sln解决方案为主另含少量cache、settings与manifest配置结构紧凑便于直接打开运行和调试。目前已有1423人学习下载。通过分析源码读者可掌握OpenFileDialog选文件、NetworkCredential建立UNC连接、FileStream与NetworkStream传输、BackgroundWorker异步更新进度条等关键实现并借鉴其中的错误处理与文件类型限制思路快速迁移到企业内部文件共享与数据传输场景。1. 从一次“文件明明写进去了对方却打不开”说起Winform 上传文件到共享文件夹听起来像是把File.Copy换个路径就完事但真正在企业内网里跑起来翻车点往往不在代码而在权限、凭据和网络路径这三件事上。我见过最常见的场景是程序在开发机上跑得好好的一放到车间或财务的机器上就报“拒绝访问”或者文件确实写进了共享目录但对方打开时提示文件损坏、大小为 0。这类问题不是 C# 语法问题而是 Windows 共享访问模型和 Winform UI 线程模型叠加出来的坑。这篇文章面向的是需要把本地文件通过 Winform 客户端写入局域网共享目录的开发者尤其是那些不想引入 FTP、OSS、MinIO 等额外服务只想利用现有 Windows 文件共享完成轻量级文件归集的场景。核心要解决三件事第一怎么用最小代码把文件可靠地写进共享文件夹第二怎么处理共享路径的凭据和权限避免“你不能访问此共享文件夹”这类安全策略拦截第三怎么在 Winform 里把上传进度、状态栏和异常反馈做扎实而不是让界面卡成黑匣子。如果你正在做 winform 项目案例里的文件归档模块或者被“winform 上传文件到共享文件夹”这个需求卡住下面的内容可以按顺序直接复现。我一般会先把网络路径连通性和凭据验证跑通再写上传逻辑最后才接 UI 进度这个顺序能省掉大量返工。2. 共享文件夹上传的底层逻辑与最小可运行代码2.1 为什么File.Copy有时能写、有时报“拒绝访问”Windows 共享文件夹的访问控制分两层一层是共享权限Share Permission一层是 NTFS 权限。共享权限决定“能不能从网络看到这个共享”NTFS 权限决定“看到之后能不能读写”。很多运维只给了共享权限的“完全控制”但 NTFS 权限里没有给写入结果就是File.Copy报UnauthorizedAccessException。反过来如果 NTFS 给了写但共享权限只给了“读取”同样写不进去。另一个容易被忽略的点是凭据。Winform 程序默认以当前登录用户的身份访问共享。如果当前用户没有该共享的访问权而你又不想给每个操作员单独开账号就需要在代码里临时模拟一个有权限的账号。常见做法是使用WNetAddConnection2这个 Win32 API 建立网络连接或者用LogonUserWindowsIdentity.Impersonate做模拟。前者更轻量适合只访问一个共享目录的场景。还有一个玄学问题路径写法。\\192.168.1.10\share\file.txt和\\server-name\share\file.txt在 DNS 解析正常时没区别但如果客户端和服务器不在同一个域或者 NetBIOS 被禁用用主机名可能解析失败用 IP 反而稳定。我一般会优先用 IP并在配置里留一个可切换的字段。2.2 用WNetAddConnection2建立带凭据的共享连接下面这段代码是 Winform 里最常用的共享连接封装。它不依赖任何第三方库直接调用mpr.dll。注意连接建立后后续的File.Copy就会以指定用户的身份访问共享。using System; using System.Runtime.InteropServices; public static class NetworkShare { [DllImport(mpr.dll, CharSet CharSet.Unicode)] private static extern int WNetAddConnection2( NETRESOURCE lpNetResource, string lpPassword, string lpUsername, int dwFlags); [DllImport(mpr.dll, CharSet CharSet.Unicode)] private static extern int WNetCancelConnection2( string lpName, int dwFlags, bool fForce); [StructLayout(LayoutKind.Sequential, CharSet CharSet.Unicode)] private class NETRESOURCE { public int dwScope 0; public int dwType 1; // RESOURCETYPE_DISK public int dwDisplayType 0; public int dwUsage 0; public string lpLocalName null; public string lpRemoteName null; public string lpComment null; public string lpProvider null; } // 连接共享返回 0 表示成功 public static int Connect(string remotePath, string username, string password) { NETRESOURCE nr new NETRESOURCE { lpRemoteName remotePath }; // dwFlags 0 表示持久连接重启后仍保留 return WNetAddConnection2(nr, password, username, 0); } // 断开共享连接 public static int Disconnect(string remotePath) { return WNetCancelConnection2(remotePath, 0, true); } }逻辑说明WNetAddConnection2的第三个参数是用户名格式建议用域\用户名或服务器名\用户名如果对方是工作组环境直接用用户名即可。第四个参数dwFlags设为 0 表示建立持久连接如果只想临时用一次可以设为CONNECT_TEMPORARY值为 1。返回值是 Windows 错误码0 表示成功53 表示找不到网络路径1326 表示用户名或密码错误5 表示拒绝访问。参数说明remotePath写共享根路径比如\\192.168.1.10\Upload不要带文件名。username和password建议从配置文件读取不要硬编码在代码里。连接成功后后续所有对\\192.168.1.10\Upload下路径的读写都会用这个身份。2.3 上传文件的最小实现与进度回调连接建立后上传本身可以用File.Copy但File.Copy没有进度回调大文件会让界面卡死。我一般会自己写一个带缓冲区的流式复制每写一块就回调一次进度。下面是一个可复用的上传方法using System; using System.IO; public static class FileUploader { // 上传文件支持进度回调 public static void Upload( string localPath, string remotePath, Actionlong, long progress null) { const int bufferSize 81920; // 80KB 缓冲区 byte[] buffer new byte[bufferSize]; long totalBytes new FileInfo(localPath).Length; long uploadedBytes 0; using (FileStream source new FileStream( localPath, FileMode.Open, FileAccess.Read, FileShare.Read)) using (FileStream target new FileStream( remotePath, FileMode.Create, FileAccess.Write, FileShare.None)) { int read; while ((read source.Read(buffer, 0, buffer.Length)) 0) { target.Write(buffer, 0, read); uploadedBytes read; progress?.Invoke(uploadedBytes, totalBytes); } } } }逻辑说明缓冲区设为 80KB 是经验值太小会增加 IO 次数太大在低速网络上反而容易超时。FileShare.None确保上传过程中没有其他进程写入同一个目标文件。进度回调传入已上传字节和总字节UI 层可以据此更新进度条。参数说明localPath是本地完整路径remotePath是共享路径下的完整文件路径比如\\192.168.1.10\Upload\2024\report.xlsx。如果目标目录不存在需要先调用Directory.CreateDirectory但注意共享目录的创建权限也要提前确认。2.4 在 Winform 里把上传放到后台线程Winform 的 UI 线程不能被阻塞否则进度条不会刷新窗口还会显示“无响应”。常见做法是Task.Run加IProgressT。下面是一个按钮点击事件的完整写法private async void btnUpload_Click(object sender, EventArgs e) { string localFile D:\data\report.xlsx; string remoteDir \\192.168.1.10\Upload\2024; string remoteFile Path.Combine(remoteDir, Path.GetFileName(localFile)); // 先建立共享连接 int connectResult NetworkShare.Connect( \\192.168.1.10\Upload, domain\\user, password); if (connectResult ! 0) { MessageBox.Show($共享连接失败错误码{connectResult}); return; } var progress new Progresslong(bytes { // 更新进度条和状态栏 progressBar.Value (int)(bytes * 100 / new FileInfo(localFile).Length); statusLabel.Text $已上传 {bytes / 1024} KB; }); try { await Task.Run(() { if (!Directory.Exists(remoteDir)) Directory.CreateDirectory(remoteDir); FileUploader.Upload(localFile, remoteFile, (sent, total) { ((IProgresslong)progress).Report(sent); }); }); statusLabel.Text 上传完成; } catch (Exception ex) { MessageBox.Show($上传失败{ex.Message}); } finally { NetworkShare.Disconnect(\\192.168.1.10\Upload); } }逻辑说明Task.Run把上传放到线程池Progresslong自动把回调切回 UI 线程所以可以直接操作控件。Directory.CreateDirectory在共享路径上同样有效但前提是账号有创建目录的权限。最后在finally里断开连接避免凭据残留。参数说明progressBar和statusLabel是窗体上的控件名按实际项目替换。NetworkShare.Connect的用户名格式根据环境调整域环境用域\用户名工作组用服务器名\用户名或直接用户名。3. 共享权限、凭据与网络路径的排查方法3.1 共享权限和 NTFS 权限的交叉验证当上传报“拒绝访问”时不要急着改代码先按下面三步排查第一步在客户端用net use \\192.168.1.10\Upload /user:domain\user password手动建立连接看是否成功。如果这一步就失败说明是凭据或网络问题不是代码问题。第二步连接成功后在资源管理器地址栏输入\\192.168.1.10\Upload尝试手动新建一个文本文件。如果手动也建不了说明是权限问题需要检查服务器端的共享权限和 NTFS 权限。第三步在服务器上右键共享文件夹 → 属性 → 共享 → 高级共享 → 权限确认目标账号有“更改”或“完全控制”。然后切到“安全”选项卡确认同一账号在 NTFS 权限里也有“修改”或“写入”。两层都满足才能写入。常见误区是只看了“共享”选项卡就以为权限给够了忽略了“安全”选项卡。我一般会让运维把两层权限截图发过来避免来回扯皮。3.2 用net use和net share做快速诊断在客户端命令行执行net use可以查看当前已有的网络连接。如果之前用错误凭据连接过Windows 会缓存这个连接导致后续用正确凭据也报错。这时候需要先net use \\192.168.1.10\Upload /delete清除旧连接再重新连接。在服务器端执行net share可以列出所有共享及其路径。确认目标共享确实存在并且路径没有写错。如果共享名带空格或特殊字符在代码里要用完整路径不要用短名称。另一个容易翻车的点是Windows 10/11 默认禁用了 SMB1如果对方服务器是老旧的 Windows Server 2003 或某些 NAS可能只支持 SMB1。这种情况下需要在客户端启用 SMB1 支持但出于安全考虑我一般建议升级服务器端而不是降级客户端。3.3 处理“你不能访问此共享文件夹因为你组织的安全策略阻止”这个报错通常出现在客户端加入了域但域策略禁止了“不安全的来宾登录”。解决方法是在客户端本地组策略中找到“计算机配置 → 管理模板 → 网络 → Lanman 工作站 → 启用不安全的来宾登录”设为“已启用”。但更稳妥的做法是给共享账号配置正确的凭据而不是依赖来宾登录。如果客户端和服务器不在同一个域且无法修改组策略可以在代码里用WNetAddConnection2显式传入用户名和密码这样就不走来宾通道。这也是我在 2.2 节里优先用这个 API 的原因。还有一个隐藏坑如果共享路径的服务器名和客户端 DNS 解析不一致比如客户端把fileserver解析到了错误的 IP也会报安全策略阻止。这时候用 IP 替代主机名通常能绕过。4. 大文件、断网与并发上传的避坑记录4.1 现象上传到 99% 卡住然后报“网络名不再可用”原因共享连接在传输过程中被服务器或网络设备断开常见于防火墙空闲超时、服务器休眠或网线松动。FileStream在写入时不会自动重连一旦底层连接断开后续写入直接抛异常。解决在Upload方法里捕获IOException记录已上传字节数然后尝试重新建立共享连接从断点继续写入。实现上可以用FileStream的Seek方法定位到已上传位置以FileMode.OpenOrCreate打开目标文件追加写入。但要注意如果目标文件被其他进程占用追加会失败所以并发场景下需要加锁或改用临时文件加改名的方式。4.2 现象多个客户端同时上传同名文件后上传的覆盖了先上传的原因共享目录没有做文件命名隔离多个操作员上传同一个模板文件时FileMode.Create会直接覆盖。解决在文件名里加入客户端标识或时间戳比如report_20240520_143022_客户端A.xlsx。如果业务要求必须同名可以在服务器端用文件锁或队列服务做串行化但这就超出了纯共享文件夹方案的范畴。我一般会在上传前检查目标文件是否存在如果存在就自动加后缀(1)、(2)类似浏览器下载的行为。4.3 现象上传小文件正常上传超过 2GB 的文件报“参数错误”原因某些老旧的共享服务器或 NAS 对单个文件大小有限制或者客户端使用的FileStream缓冲区设置不当导致大文件写入时溢出。解决确认服务器端文件系统是 NTFS 而不是 FAT32FAT32 单文件上限是 4GB。如果是 NAS检查其 SMB 配置里是否有文件大小限制。代码层面把缓冲区设为 80KB 到 1MB 之间不要用int存总字节数改用long。上面 2.3 节的代码已经用了long可以避免这个问题。4.4 现象上传过程中界面卡死进度条不动原因上传代码直接写在按钮事件里没有用Task.Run或者用了Task.Run但进度回调没有切回 UI 线程。解决确保上传逻辑在Task.Run里执行进度回调使用IProgressT或Control.Invoke。不要直接在后台线程里操作progressBar.Value否则会抛跨线程异常。如果用了async/await注意不要在Task.Run里再调用Control.Invoke否则可能死锁。4.5 现象程序退出后共享连接仍然存在导致其他程序无法用不同凭据访问原因WNetAddConnection2建立的持久连接在进程退出后不会自动断开Windows 会保留这个连接直到重启或手动删除。解决在程序退出时调用WNetCancelConnection2断开连接。如果程序异常崩溃可以在下次启动时先执行net use \\server\share /delete清理旧连接。我一般会在FormClosing事件里做清理并在配置文件里记录上次连接的共享路径启动时先清理再重连。5. 把上传做成可配置、可验证的稳定模块5.1 用配置文件管理共享路径和凭据硬编码路径和密码是后期维护的噩梦。我一般会在App.config或appsettings.json里放这些字段appSettings add keyShareRoot value\\192.168.1.10\Upload/ add keyShareUser valuedomain\fileuser/ add keySharePassword valueencrypted_password/ add keyRemoteSubDir value2024/ /appSettings密码不要明文存储可以用ProtectedData.Protect做当前用户加密或者用 Windows 凭据管理器。读取时用ConfigurationManager.AppSettings这样换环境只需要改配置文件不用重新编译。5.2 上传前做一次连通性预检在正式上传前先做一次轻量级预检可以避免大文件传到一半才发现权限不对。预检逻辑包括共享连接是否成功、目标目录是否存在、是否有写入权限。下面是一个预检方法public static bool PreCheck(string remoteDir, string username, string password) { int result NetworkShare.Connect(remoteDir, username, password); if (result ! 0) return false; try { string testFile Path.Combine(remoteDir, $__test_{Guid.NewGuid():N}.tmp); File.WriteAllText(testFile, test); File.Delete(testFile); return true; } catch { return false; } finally { NetworkShare.Disconnect(remoteDir); } }逻辑说明连接成功后在目标目录写一个临时文件再删除能同时验证写入权限和删除权限。如果这一步失败就不用继续上传了直接提示用户检查权限。参数说明remoteDir是共享下的目标目录不是共享根。如果目标目录不存在File.WriteAllText会抛DirectoryNotFoundException所以预检前要先确保目录存在或者把目录创建也纳入预检。5.3 用状态栏和日志记录上传结果Winform 的状态栏适合显示简短状态但排查问题时需要更详细的日志。我一般会在上传模块里加一个简单的日志方法记录时间、文件名、大小、耗时和结果。日志写到本地Logs目录按天分文件。这样当用户反馈“上传失败”时可以直接看日志定位是连接问题、权限问题还是文件本身的问题。状态栏更新要注意频率不要每写 80KB 就刷新一次否则 UI 线程会被大量回调淹没。可以在进度回调里做节流比如每 500 毫秒更新一次或者每上传 1% 更新一次。5.4 验证上传完整性的两个实用技巧第一个技巧上传完成后比较本地文件和远程文件的大小。如果大小不一致说明传输过程中有丢失。可以在上传结束后用FileInfo分别读取本地和远程文件长度不一致就报警。第二个技巧对于关键文件上传后计算 MD5 或 SHA256 并比对。本地算一次远程算一次一致才算成功。远程计算哈希需要把文件读回来大文件会慢所以只对重要文件做。我一般会在配置文件里加一个VerifyHash开关默认关闭需要时打开。5.5 我踩过的最深的一个坑早期做这个功能时我直接在按钮事件里用File.Copy上传没有建共享连接依赖当前登录用户的凭据。开发机上当前用户是域管理员一切正常。部署到车间电脑后操作员用的是本地账号共享访问直接被拒。更麻烦的是Windows 缓存了之前用管理员凭据建立的连接导致即使用正确凭据也连不上必须重启才能清除。后来我养成了一个习惯只要涉及共享文件夹第一件事就是用WNetAddConnection2显式传凭据并且在程序退出时清理连接。这个习惯帮我省掉了至少三次现场排查。希望帮到你。本文还有配套的精品资源点击获取 Winform上传文件到共享文件夹：权限、凭据与进度处理实战
简介这份资源面向C# Winform开发者尤其是需要实现局域网文件传输功能的中级学习者提供了一套将本地文件上传至服务器共享文件夹的完整解决方案。项目基于VS2010环境围绕文件选择、网络凭据连接、文件流读写、进度显示、异常处理与安全校验等环节展开帮助读者理解共享文件夹访问与网络编程的配合方式。压缩包共23个文件约36KB以cs源码、exe可执行文件、pdb调试符号、resx与resources资源文件、csproj工程文件及sln解决方案为主另含少量cache、settings与manifest配置结构紧凑便于直接打开运行和调试。目前已有1423人学习下载。通过分析源码读者可掌握OpenFileDialog选文件、NetworkCredential建立UNC连接、FileStream与NetworkStream传输、BackgroundWorker异步更新进度条等关键实现并借鉴其中的错误处理与文件类型限制思路快速迁移到企业内部文件共享与数据传输场景。1. 从一次“文件明明写进去了对方却打不开”说起Winform 上传文件到共享文件夹听起来像是把File.Copy换个路径就完事但真正在企业内网里跑起来翻车点往往不在代码而在权限、凭据和网络路径这三件事上。我见过最常见的场景是程序在开发机上跑得好好的一放到车间或财务的机器上就报“拒绝访问”或者文件确实写进了共享目录但对方打开时提示文件损坏、大小为 0。这类问题不是 C# 语法问题而是 Windows 共享访问模型和 Winform UI 线程模型叠加出来的坑。这篇文章面向的是需要把本地文件通过 Winform 客户端写入局域网共享目录的开发者尤其是那些不想引入 FTP、OSS、MinIO 等额外服务只想利用现有 Windows 文件共享完成轻量级文件归集的场景。核心要解决三件事第一怎么用最小代码把文件可靠地写进共享文件夹第二怎么处理共享路径的凭据和权限避免“你不能访问此共享文件夹”这类安全策略拦截第三怎么在 Winform 里把上传进度、状态栏和异常反馈做扎实而不是让界面卡成黑匣子。如果你正在做 winform 项目案例里的文件归档模块或者被“winform 上传文件到共享文件夹”这个需求卡住下面的内容可以按顺序直接复现。我一般会先把网络路径连通性和凭据验证跑通再写上传逻辑最后才接 UI 进度这个顺序能省掉大量返工。2. 共享文件夹上传的底层逻辑与最小可运行代码2.1 为什么File.Copy有时能写、有时报“拒绝访问”Windows 共享文件夹的访问控制分两层一层是共享权限Share Permission一层是 NTFS 权限。共享权限决定“能不能从网络看到这个共享”NTFS 权限决定“看到之后能不能读写”。很多运维只给了共享权限的“完全控制”但 NTFS 权限里没有给写入结果就是File.Copy报UnauthorizedAccessException。反过来如果 NTFS 给了写但共享权限只给了“读取”同样写不进去。另一个容易被忽略的点是凭据。Winform 程序默认以当前登录用户的身份访问共享。如果当前用户没有该共享的访问权而你又不想给每个操作员单独开账号就需要在代码里临时模拟一个有权限的账号。常见做法是使用WNetAddConnection2这个 Win32 API 建立网络连接或者用LogonUserWindowsIdentity.Impersonate做模拟。前者更轻量适合只访问一个共享目录的场景。还有一个玄学问题路径写法。\\192.168.1.10\share\file.txt和\\server-name\share\file.txt在 DNS 解析正常时没区别但如果客户端和服务器不在同一个域或者 NetBIOS 被禁用用主机名可能解析失败用 IP 反而稳定。我一般会优先用 IP并在配置里留一个可切换的字段。2.2 用WNetAddConnection2建立带凭据的共享连接下面这段代码是 Winform 里最常用的共享连接封装。它不依赖任何第三方库直接调用mpr.dll。注意连接建立后后续的File.Copy就会以指定用户的身份访问共享。using System; using System.Runtime.InteropServices; public static class NetworkShare { [DllImport(mpr.dll, CharSet CharSet.Unicode)] private static extern int WNetAddConnection2( NETRESOURCE lpNetResource, string lpPassword, string lpUsername, int dwFlags); [DllImport(mpr.dll, CharSet CharSet.Unicode)] private static extern int WNetCancelConnection2( string lpName, int dwFlags, bool fForce); [StructLayout(LayoutKind.Sequential, CharSet CharSet.Unicode)] private class NETRESOURCE { public int dwScope 0; public int dwType 1; // RESOURCETYPE_DISK public int dwDisplayType 0; public int dwUsage 0; public string lpLocalName null; public string lpRemoteName null; public string lpComment null; public string lpProvider null; } // 连接共享返回 0 表示成功 public static int Connect(string remotePath, string username, string password) { NETRESOURCE nr new NETRESOURCE { lpRemoteName remotePath }; // dwFlags 0 表示持久连接重启后仍保留 return WNetAddConnection2(nr, password, username, 0); } // 断开共享连接 public static int Disconnect(string remotePath) { return WNetCancelConnection2(remotePath, 0, true); } }逻辑说明WNetAddConnection2的第三个参数是用户名格式建议用域\用户名或服务器名\用户名如果对方是工作组环境直接用用户名即可。第四个参数dwFlags设为 0 表示建立持久连接如果只想临时用一次可以设为CONNECT_TEMPORARY值为 1。返回值是 Windows 错误码0 表示成功53 表示找不到网络路径1326 表示用户名或密码错误5 表示拒绝访问。参数说明remotePath写共享根路径比如\\192.168.1.10\Upload不要带文件名。username和password建议从配置文件读取不要硬编码在代码里。连接成功后后续所有对\\192.168.1.10\Upload下路径的读写都会用这个身份。2.3 上传文件的最小实现与进度回调连接建立后上传本身可以用File.Copy但File.Copy没有进度回调大文件会让界面卡死。我一般会自己写一个带缓冲区的流式复制每写一块就回调一次进度。下面是一个可复用的上传方法using System; using System.IO; public static class FileUploader { // 上传文件支持进度回调 public static void Upload( string localPath, string remotePath, Actionlong, long progress null) { const int bufferSize 81920; // 80KB 缓冲区 byte[] buffer new byte[bufferSize]; long totalBytes new FileInfo(localPath).Length; long uploadedBytes 0; using (FileStream source new FileStream( localPath, FileMode.Open, FileAccess.Read, FileShare.Read)) using (FileStream target new FileStream( remotePath, FileMode.Create, FileAccess.Write, FileShare.None)) { int read; while ((read source.Read(buffer, 0, buffer.Length)) 0) { target.Write(buffer, 0, read); uploadedBytes read; progress?.Invoke(uploadedBytes, totalBytes); } } } }逻辑说明缓冲区设为 80KB 是经验值太小会增加 IO 次数太大在低速网络上反而容易超时。FileShare.None确保上传过程中没有其他进程写入同一个目标文件。进度回调传入已上传字节和总字节UI 层可以据此更新进度条。参数说明localPath是本地完整路径remotePath是共享路径下的完整文件路径比如\\192.168.1.10\Upload\2024\report.xlsx。如果目标目录不存在需要先调用Directory.CreateDirectory但注意共享目录的创建权限也要提前确认。2.4 在 Winform 里把上传放到后台线程Winform 的 UI 线程不能被阻塞否则进度条不会刷新窗口还会显示“无响应”。常见做法是Task.Run加IProgressT。下面是一个按钮点击事件的完整写法private async void btnUpload_Click(object sender, EventArgs e) { string localFile D:\data\report.xlsx; string remoteDir \\192.168.1.10\Upload\2024; string remoteFile Path.Combine(remoteDir, Path.GetFileName(localFile)); // 先建立共享连接 int connectResult NetworkShare.Connect( \\192.168.1.10\Upload, domain\\user, password); if (connectResult ! 0) { MessageBox.Show($共享连接失败错误码{connectResult}); return; } var progress new Progresslong(bytes { // 更新进度条和状态栏 progressBar.Value (int)(bytes * 100 / new FileInfo(localFile).Length); statusLabel.Text $已上传 {bytes / 1024} KB; }); try { await Task.Run(() { if (!Directory.Exists(remoteDir)) Directory.CreateDirectory(remoteDir); FileUploader.Upload(localFile, remoteFile, (sent, total) { ((IProgresslong)progress).Report(sent); }); }); statusLabel.Text 上传完成; } catch (Exception ex) { MessageBox.Show($上传失败{ex.Message}); } finally { NetworkShare.Disconnect(\\192.168.1.10\Upload); } }逻辑说明Task.Run把上传放到线程池Progresslong自动把回调切回 UI 线程所以可以直接操作控件。Directory.CreateDirectory在共享路径上同样有效但前提是账号有创建目录的权限。最后在finally里断开连接避免凭据残留。参数说明progressBar和statusLabel是窗体上的控件名按实际项目替换。NetworkShare.Connect的用户名格式根据环境调整域环境用域\用户名工作组用服务器名\用户名或直接用户名。3. 共享权限、凭据与网络路径的排查方法3.1 共享权限和 NTFS 权限的交叉验证当上传报“拒绝访问”时不要急着改代码先按下面三步排查第一步在客户端用net use \\192.168.1.10\Upload /user:domain\user password手动建立连接看是否成功。如果这一步就失败说明是凭据或网络问题不是代码问题。第二步连接成功后在资源管理器地址栏输入\\192.168.1.10\Upload尝试手动新建一个文本文件。如果手动也建不了说明是权限问题需要检查服务器端的共享权限和 NTFS 权限。第三步在服务器上右键共享文件夹 → 属性 → 共享 → 高级共享 → 权限确认目标账号有“更改”或“完全控制”。然后切到“安全”选项卡确认同一账号在 NTFS 权限里也有“修改”或“写入”。两层都满足才能写入。常见误区是只看了“共享”选项卡就以为权限给够了忽略了“安全”选项卡。我一般会让运维把两层权限截图发过来避免来回扯皮。3.2 用net use和net share做快速诊断在客户端命令行执行net use可以查看当前已有的网络连接。如果之前用错误凭据连接过Windows 会缓存这个连接导致后续用正确凭据也报错。这时候需要先net use \\192.168.1.10\Upload /delete清除旧连接再重新连接。在服务器端执行net share可以列出所有共享及其路径。确认目标共享确实存在并且路径没有写错。如果共享名带空格或特殊字符在代码里要用完整路径不要用短名称。另一个容易翻车的点是Windows 10/11 默认禁用了 SMB1如果对方服务器是老旧的 Windows Server 2003 或某些 NAS可能只支持 SMB1。这种情况下需要在客户端启用 SMB1 支持但出于安全考虑我一般建议升级服务器端而不是降级客户端。3.3 处理“你不能访问此共享文件夹因为你组织的安全策略阻止”这个报错通常出现在客户端加入了域但域策略禁止了“不安全的来宾登录”。解决方法是在客户端本地组策略中找到“计算机配置 → 管理模板 → 网络 → Lanman 工作站 → 启用不安全的来宾登录”设为“已启用”。但更稳妥的做法是给共享账号配置正确的凭据而不是依赖来宾登录。如果客户端和服务器不在同一个域且无法修改组策略可以在代码里用WNetAddConnection2显式传入用户名和密码这样就不走来宾通道。这也是我在 2.2 节里优先用这个 API 的原因。还有一个隐藏坑如果共享路径的服务器名和客户端 DNS 解析不一致比如客户端把fileserver解析到了错误的 IP也会报安全策略阻止。这时候用 IP 替代主机名通常能绕过。4. 大文件、断网与并发上传的避坑记录4.1 现象上传到 99% 卡住然后报“网络名不再可用”原因共享连接在传输过程中被服务器或网络设备断开常见于防火墙空闲超时、服务器休眠或网线松动。FileStream在写入时不会自动重连一旦底层连接断开后续写入直接抛异常。解决在Upload方法里捕获IOException记录已上传字节数然后尝试重新建立共享连接从断点继续写入。实现上可以用FileStream的Seek方法定位到已上传位置以FileMode.OpenOrCreate打开目标文件追加写入。但要注意如果目标文件被其他进程占用追加会失败所以并发场景下需要加锁或改用临时文件加改名的方式。4.2 现象多个客户端同时上传同名文件后上传的覆盖了先上传的原因共享目录没有做文件命名隔离多个操作员上传同一个模板文件时FileMode.Create会直接覆盖。解决在文件名里加入客户端标识或时间戳比如report_20240520_143022_客户端A.xlsx。如果业务要求必须同名可以在服务器端用文件锁或队列服务做串行化但这就超出了纯共享文件夹方案的范畴。我一般会在上传前检查目标文件是否存在如果存在就自动加后缀(1)、(2)类似浏览器下载的行为。4.3 现象上传小文件正常上传超过 2GB 的文件报“参数错误”原因某些老旧的共享服务器或 NAS 对单个文件大小有限制或者客户端使用的FileStream缓冲区设置不当导致大文件写入时溢出。解决确认服务器端文件系统是 NTFS 而不是 FAT32FAT32 单文件上限是 4GB。如果是 NAS检查其 SMB 配置里是否有文件大小限制。代码层面把缓冲区设为 80KB 到 1MB 之间不要用int存总字节数改用long。上面 2.3 节的代码已经用了long可以避免这个问题。4.4 现象上传过程中界面卡死进度条不动原因上传代码直接写在按钮事件里没有用Task.Run或者用了Task.Run但进度回调没有切回 UI 线程。解决确保上传逻辑在Task.Run里执行进度回调使用IProgressT或Control.Invoke。不要直接在后台线程里操作progressBar.Value否则会抛跨线程异常。如果用了async/await注意不要在Task.Run里再调用Control.Invoke否则可能死锁。4.5 现象程序退出后共享连接仍然存在导致其他程序无法用不同凭据访问原因WNetAddConnection2建立的持久连接在进程退出后不会自动断开Windows 会保留这个连接直到重启或手动删除。解决在程序退出时调用WNetCancelConnection2断开连接。如果程序异常崩溃可以在下次启动时先执行net use \\server\share /delete清理旧连接。我一般会在FormClosing事件里做清理并在配置文件里记录上次连接的共享路径启动时先清理再重连。5. 把上传做成可配置、可验证的稳定模块5.1 用配置文件管理共享路径和凭据硬编码路径和密码是后期维护的噩梦。我一般会在App.config或appsettings.json里放这些字段appSettings add keyShareRoot value\\192.168.1.10\Upload/ add keyShareUser valuedomain\fileuser/ add keySharePassword valueencrypted_password/ add keyRemoteSubDir value2024/ /appSettings密码不要明文存储可以用ProtectedData.Protect做当前用户加密或者用 Windows 凭据管理器。读取时用ConfigurationManager.AppSettings这样换环境只需要改配置文件不用重新编译。5.2 上传前做一次连通性预检在正式上传前先做一次轻量级预检可以避免大文件传到一半才发现权限不对。预检逻辑包括共享连接是否成功、目标目录是否存在、是否有写入权限。下面是一个预检方法public static bool PreCheck(string remoteDir, string username, string password) { int result NetworkShare.Connect(remoteDir, username, password); if (result ! 0) return false; try { string testFile Path.Combine(remoteDir, $__test_{Guid.NewGuid():N}.tmp); File.WriteAllText(testFile, test); File.Delete(testFile); return true; } catch { return false; } finally { NetworkShare.Disconnect(remoteDir); } }逻辑说明连接成功后在目标目录写一个临时文件再删除能同时验证写入权限和删除权限。如果这一步失败就不用继续上传了直接提示用户检查权限。参数说明remoteDir是共享下的目标目录不是共享根。如果目标目录不存在File.WriteAllText会抛DirectoryNotFoundException所以预检前要先确保目录存在或者把目录创建也纳入预检。5.3 用状态栏和日志记录上传结果Winform 的状态栏适合显示简短状态但排查问题时需要更详细的日志。我一般会在上传模块里加一个简单的日志方法记录时间、文件名、大小、耗时和结果。日志写到本地Logs目录按天分文件。这样当用户反馈“上传失败”时可以直接看日志定位是连接问题、权限问题还是文件本身的问题。状态栏更新要注意频率不要每写 80KB 就刷新一次否则 UI 线程会被大量回调淹没。可以在进度回调里做节流比如每 500 毫秒更新一次或者每上传 1% 更新一次。5.4 验证上传完整性的两个实用技巧第一个技巧上传完成后比较本地文件和远程文件的大小。如果大小不一致说明传输过程中有丢失。可以在上传结束后用FileInfo分别读取本地和远程文件长度不一致就报警。第二个技巧对于关键文件上传后计算 MD5 或 SHA256 并比对。本地算一次远程算一次一致才算成功。远程计算哈希需要把文件读回来大文件会慢所以只对重要文件做。我一般会在配置文件里加一个VerifyHash开关默认关闭需要时打开。5.5 我踩过的最深的一个坑早期做这个功能时我直接在按钮事件里用File.Copy上传没有建共享连接依赖当前登录用户的凭据。开发机上当前用户是域管理员一切正常。部署到车间电脑后操作员用的是本地账号共享访问直接被拒。更麻烦的是Windows 缓存了之前用管理员凭据建立的连接导致即使用正确凭据也连不上必须重启才能清除。后来我养成了一个习惯只要涉及共享文件夹第一件事就是用WNetAddConnection2显式传凭据并且在程序退出时清理连接。这个习惯帮我省掉了至少三次现场排查。希望帮到你。本文还有配套的精品资源点击获取