正文

C#实现的文件操作封装类完整实例【删除,移动,复制,重命名】

︶ㄣ米米素材网 メ
米米素材网V管理员 / 阅读
0708

这篇文章主要介绍了C#实现的文件操作封装类,结合完整实例形式分析了C#封装文件的删除,移动,复制,重命名等操作相关实现技巧,需要的朋友可以参考下

本文实例讲述了C#实现的文件操作封装类。分享给大家供大家参考，具体如下：

最近发现群共享里面有个C# 文件操作封装类，其方法是调用Windows API 来操作的文件的删除、移动、复制、重命名操作。下载下来一试，发现果然不错，特在此记录，以防丢失！

文件操作类代码如下：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
using System;
using System.Runtime.InteropServices;
using System.IO;
namespace LxFile
{
  /// <summary>
  /// 文件操作代理，该类提供类似于Windows的文件操作体验
  /// </summary>
  public class FileOperateProxy
  {
    #region 【内部类型定义】
    private struct SHFILEOPSTRUCT
    {
      public IntPtr hwnd;     //父窗口句柄
      public wFunc wFunc;     //要执行的动作
      public string pFrom;    //源文件路径，可以是多个文件，以结尾符号"\0"结束
      public string pTo;     //目标路径，可以是路径或文件名
      public FILEOP_FLAGS fFlags;       //标志，附加选项
      public bool fAnyOperationsAborted;   //是否可被中断
      public IntPtr hNameMappings;      //文件映射名字，可在其它 Shell 函数中使用
      public string lpszProgressTitle;    // 只在 FOF_SIMPLEPROGRESS 时，指定对话框的标题。
    }
    private enum wFunc
    {
      FO_MOVE = 0x0001,  //移动文件
      FO_COPY = 0x0002,  //复制文件
      FO_DELETE = 0x0003, //删除文件，只是用pFrom
      FO_RENAME = 0x0004 //文件重命名
    }
    private enum FILEOP_FLAGS
    {
      FOF_MULTIDESTFILES = 0x0001,  //pTo 指定了多个目标文件，而不是单个目录
      FOF_CONFIRMMOUSE = 0x0002,
      FOF_SILENT = 0x0044,      // 不显示一个进度对话框
      FOF_RENAMEONCOLLISION = 0x0008, // 碰到有抵触的名字时，自动分配前缀
      FOF_NOCONFIRMATION = 0x10,   // 不对用户显示提示
      FOF_WANTMAPPINGHANDLE = 0x0020, // 填充 hNameMappings 字段，必须使用 SHFreeNameMappings 释放
      FOF_ALLOWUNDO = 0x40,      // 允许撤销
      FOF_FILESONLY = 0x0080,     // 使用 *.* 时, 只对文件操作
      FOF_SIMPLEPROGRESS = 0x0100,  // 简单进度条，意味者不显示文件名。
      FOF_NOCONFIRMMKDIR = 0x0200,  // 建新目录时不需要用户确定
      FOF_NOERRORUI = 0x0400,     // 不显示出错用户界面
      FOF_NOCOPYSECURITYATTRIBS = 0x0800,   // 不复制 NT 文件的安全属性
      FOF_NORECURSION = 0x1000    // 不递归目录
    }
    #endregion 【内部类型定义】
    #region 【DllImport】
    [DllImport("shell32.dll")]
    private static extern int SHFileOperation(ref SHFILEOPSTRUCT lpFileOp);
    #endregion 【DllImport】
    #region 【删除文件操作】
    /// <summary>
    /// 删除单个文件。
    /// </summary>
    /// <param name="fileName">删除的文件名</param>
    /// <param name="toRecycle">指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效</param>
    /// <param name="errorMsg">反馈错误消息的字符串</param>
    /// <returns>操作执行结果标识，删除文件成功返回0，否则，返回错误代码</returns>
    public static int DeleteFile(string fileName, bool toRecycle, bool showDialog, bool showProgress, ref string errorMsg)
    {
      try
      {
        string fName = GetFullName(fileName);
        return ToDelete(fName, toRecycle, showDialog, showProgress, ref errorMsg);
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    /// <summary>
    /// 删除一组文件。
    /// </summary>
    /// <param name="fileNames">字符串数组，表示一组文件名</param>
    /// <param name="toRecycle">指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效</param>
    /// <param name="errorMsg">反馈错误消息的字符串</param>
    /// <returns>操作执行结果标识，删除文件成功返回0，否则，返回错误代码</returns>
    public static int DeleteFiles(string[] fileNames, bool toRecycle, bool showDialog, bool showProgress, ref string errorMsg)
    {
      try
      {
        string fName = "";
        foreach (string str in fileNames)
        {
          fName += GetFullName(str) + "\0";   //组件文件组字符串
        }
        return ToDelete(fName, toRecycle, showDialog, showProgress, ref errorMsg);
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    #endregion 【删除文件操作】
    #region 【移动文件操作】
    /// <summary>
    /// 移动一个文件到指定路径下
    /// </summary>
    /// <param name="sourceFileName">要移动的文件名</param>
    /// <param name="destinationPath">移动到的目的路径</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框</param>
    /// <param name="autoRename">指示当文件名重复时，是否自动为新文件加上后缀名</param>
    /// <param name="errorMsg">反馈错误消息的字符串</param>
    /// <returns>返回移动操作是否成功的标识，成功返回0，失败返回错误代码</returns>
    public static int MoveFile(string sourceFileName, string destinationPath, bool showDialog, bool showProgress, bool autoRename, ref string errorMsg)
    {
      try
      {
        string sfName = GetFullName(sourceFileName);
        string dfName = GetFullName(destinationPath);
        return ToMoveOrCopy(wFunc.FO_MOVE, sfName, dfName, showDialog, showProgress, autoRename, ref errorMsg);
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    /// <summary>
    /// 移动一组文件到指定的路径下
    /// </summary>
    /// <param name="sourceFileNames">要移动的文件名数组</param>
    /// <param name="destinationPath">移动到的目的路径</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框</param>
    /// <param name="autoRename">指示当文件名重复时，是否自动为新文件加上后缀名</param>
    /// <param name="errorMsg">反馈错误消息的字符串</param>
    /// <returns>返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常</returns>
    public static int MoveFiles(string[] sourceFileNames, string destinationPath, bool showDialog, bool showProgress, bool autoRename, ref string errorMsg)
    {
      try
      {
        string sfName = "";
        foreach (string str in sourceFileNames)
        {
          sfName += GetFullName(str) + "\0";  //组件文件组字符串
        }
        string dfName = GetFullName(destinationPath);
        return ToMoveOrCopy(wFunc.FO_MOVE, sfName, dfName, showDialog, showProgress, autoRename, ref errorMsg);
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    #endregion 【移动文件操作】
    #region 【复制文件操作】
    /// <summary>
    /// 复制一个文件到指定的文件名或路径
    /// </summary>
    /// <param name="sourceFileName">要复制的文件名</param>
    /// <param name="destinationFileName">复制到的目的文件名或路径</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框</param>
    /// <param name="autoRename">指示当文件名重复时，是否自动为新文件加上后缀名</param>
    /// <returns>返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常</returns>
    public static int CopyFile(string sourceFileName, string destinationFileName, bool showDialog, bool showProgress, bool autoRename, ref string errorMsg)
    {
      try
      {
        string sfName = GetFullName(sourceFileName);
        string dfName = GetFullName(destinationFileName);
        return ToMoveOrCopy(wFunc.FO_COPY, sfName, dfName, showDialog, showProgress, autoRename, ref errorMsg);
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    /// <summary>
    /// 复制一组文件到指定的路径
    /// </summary>
    /// <param name="sourceFileNames">要复制的文件名数组</param>
    /// <param name="destinationPath">复制到的目的路径</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框</param>
    /// <param name="autoRename">指示当文件名重复时，是否自动为新文件加上后缀名</param>
    /// <returns>返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常</returns>
    public static int CopyFiles(string[] sourceFileNames, string destinationPath, bool showDialog, bool showProgress, bool autoRename, ref string errorMsg)
    {
      try
      {
        string sfName = "";
        foreach (string str in sourceFileNames)
        {
          sfName += GetFullName(str) + "\0";   //组件文件组字符串
        }
        string dfName = GetFullName(destinationPath);
        return ToMoveOrCopy(wFunc.FO_COPY, sfName, dfName, showDialog, showProgress, autoRename, ref errorMsg);
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    #endregion 【复制文件操作】
    #region 【重命名文件】
    /// <summary>
    /// 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法
    /// </summary>
    /// <param name="sourceFileName">要复制的文件名</param>
    /// <param name="destinationFileName">复制到的目的文件名或路径</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框</param>
    /// <returns>返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常</returns>
    [Obsolete("建议使用 Microsoft.VisualBasic.FileSystem.ReName()方法")]
    public static int ReNameFile(string sourceFileName, string destinationFileName, bool showDialog, ref string errorMsg)
    {
      try
      {
        SHFILEOPSTRUCT lpFileOp = new SHFILEOPSTRUCT();
        lpFileOp.wFunc = wFunc.FO_RENAME;
        lpFileOp.pFrom = GetFullName(sourceFileName) + "\0\0";     //将文件名以结尾字符"\0\0"结束
        lpFileOp.pTo = GetFullName(destinationFileName) + "\0\0";
        lpFileOp.fFlags = FILEOP_FLAGS.FOF_NOERRORUI;
        if (!showDialog)
          lpFileOp.fFlags |= FILEOP_FLAGS.FOF_NOCONFIRMATION;   //设定不显示提示对话框
        lpFileOp.fAnyOperationsAborted = true;
        int n = SHFileOperation(ref lpFileOp);
        if (n == 0)
          return 0;
        string tmp = GetErrorString(n);
        errorMsg = string.Format("{0}({1})", tmp, sourceFileName);
        return n;
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    /// <summary>
    /// 利用Microsoft.VisualBasic.FileSystem.ReName()方法实现
    /// </summary>
    /// <param name="filePath"></param>
    /// <param name="newFileName"></param>
    public static void ReNameFile(string filePath, string newFileName)
    {
      try
      {
        string extensName = Path.GetExtension(filePath);
        string newName = newFileName + extensName;
        Microsoft.VisualBasic.FileIO.FileSystem.RenameFile(filePath, newName);
      }
      catch (Exception ex)
      {
        throw ex;
      }
    }
    #endregion 【重命名文件】
    /// <summary>
    /// 删除单个或多个文件
    /// </summary>
    /// <param name="fileName">删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开</param>
    /// <param name="toRecycle">指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效</param>
    /// <param name="errorMsg">反馈错误消息的字符串</param>
    /// <returns>操作执行结果标识，删除文件成功返回0，否则，返回错误代码</returns>
    private static int ToDelete(string fileName, bool toRecycle, bool showDialog, bool showProgress, ref string errorMsg)
    {
      SHFILEOPSTRUCT lpFileOp = new SHFILEOPSTRUCT();
      lpFileOp.wFunc = wFunc.FO_DELETE;
      lpFileOp.pFrom = fileName + "\0";    //将文件名以结尾字符"\0"结束
      lpFileOp.fFlags = FILEOP_FLAGS.FOF_NOERRORUI;
      if (toRecycle)
        lpFileOp.fFlags |= FILEOP_FLAGS.FOF_ALLOWUNDO; //设定删除到回收站
      if (!showDialog)
        lpFileOp.fFlags |= FILEOP_FLAGS.FOF_NOCONFIRMATION;   //设定不显示提示对话框
      if (!showProgress)
        lpFileOp.fFlags |= FILEOP_FLAGS.FOF_SILENT;   //设定不显示进度对话框
      lpFileOp.fAnyOperationsAborted = true;
      int n = SHFileOperation(ref lpFileOp);
      if (n == 0)
        return 0;
      string tmp = GetErrorString(n);
      //.av 文件正常删除了但也提示 402 错误，不知道为什么。屏蔽之。
      if ((fileName.ToLower().EndsWith(".av") && n.ToString("X") == "402"))
        return 0;
      errorMsg = string.Format("{0}({1})", tmp, fileName);
      return n;
    }
    /// <summary>
    /// 移动或复制一个或多个文件到指定路径下
    /// </summary>
    /// <param name="flag">操作类型，是移动操作还是复制操作</param>
    /// <param name="sourceFileName">要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开</param>
    /// <param name="destinationFileName">移动到的目的位置</param>
    /// <param name="showDialog">指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框</param>
    /// <param name="showProgress">指示是否显示进度对话框</param>
    /// <param name="autoRename">指示当文件名重复时，是否自动为新文件加上后缀名</param>
    /// <param name="errorMsg">反馈错误消息的字符串</param>
    /// <returns>返回移动操作是否成功的标识，成功返回0，失败返回错误代码</returns>
    private static int ToMoveOrCopy(wFunc flag, string sourceFileName, string destinationFileName, bool showDialog, bool showProgress, bool autoRename, ref string errorMsg)
    {
      SHFILEOPSTRUCT lpFileOp = new SHFILEOPSTRUCT();
      lpFileOp.wFunc = flag;
      lpFileOp.pFrom = sourceFileName + "\0";     //将文件名以结尾字符"\0\0"结束
      lpFileOp.pTo = destinationFileName + "\0\0";
      lpFileOp.fFlags = FILEOP_FLAGS.FOF_NOERRORUI;
      lpFileOp.fFlags |= FILEOP_FLAGS.FOF_NOCONFIRMMKDIR; //指定在需要时可以直接创建路径
      if (!showDialog)
        lpFileOp.fFlags |= FILEOP_FLAGS.FOF_NOCONFIRMATION;   //设定不显示提示对话框
      if (!showProgress)
        lpFileOp.fFlags |= FILEOP_FLAGS.FOF_SILENT;   //设定不显示进度对话框
      if (autoRename)
        lpFileOp.fFlags |= FILEOP_FLAGS.FOF_RENAMEONCOLLISION; //自动为重名文件添加名称后缀
      lpFileOp.fAnyOperationsAborted = true;
      int n = SHFileOperation(ref lpFileOp);
      if (n == 0)
        return 0;
      string tmp = GetErrorString(n);
      errorMsg = string.Format("{0}({1})", tmp, sourceFileName);
      return n;
    }
    /// <summary>
    /// 获取一个文件的全名
    /// </summary>
    /// <param name="fileName">文件名</param>
    /// <returns>返回生成文件的完整路径名</returns>
    private static string GetFullName(string fileName)
    {
      FileInfo fi = new FileInfo(fileName);
      return fi.FullName;
    }
    /// <summary>
    /// 解释错误代码
    /// </summary>
    /// <param name="n">代码号</param>
    /// <returns>返回关于错误代码的文字描述</returns>
    private static string GetErrorString(int n)
    {
      if (n == 0) return string.Empty;
      switch (n)
      {
        case 2:
          return "系统找不到指定的文件。";
        case 7:
          return "存储控制块被销毁。您是否选择的“取消”操作？";
        case 113:
          return "文件已存在！";
        case 115:
          return "重命名文件操作,原始文件和目标文件必须具有相同的路径名。不能使用相对路径。";
        case 117:
          return "I/O控制错误";
        case 123:
          return "指定了重复的文件名";
        case 116:
          return "The source is a root directory, which cannot be moved or renamed.";
        case 118:
          return "Security settings denied access to the source.";
        case 124:
          return "The path in the source or destination or both was invalid.";
        case 65536:
          return "An unspecified error occurred on the destination.";
        case 1026:
          return "在试图移动或拷贝一个不存在的文件.";
        case 1223:
          return "操作被取消！";
        default:
          return "未识别的错误代码：" + n;
      }
    }
  }
}

附：完整实例代码点击此处本站下载。

希望本文所述对大家C#程序设计有所帮助。