C#实现的文件操作封装类完整实例

作者：袖梨 2022-06-25

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

文件操作类代码如下：

 
using System;
using System.Runtime.InteropServices;
using System.IO;
namespace LxFile
{
  ///
  /// 文件操作代理，该类提供类似于Windows的文件操作体验
  ///
  public class FileOperateProxy
  {
    #region 【内部类型定义】
    private struct SHFILEOPSTRUCT
    {
      public IntPtr hwnd;     //父窗口句柄
      public wFunc wFunc;     //要执行的动作
      public string pFrom;    //源文件路径，可以是多个文件，以结尾符号""结束
      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 【删除文件操作】
    ///
    /// 删除单个文件。
    ///
    ///删除的文件名
    ///指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除
    ///指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框
    ///指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效
    ///反馈错误消息的字符串
    ///操作执行结果标识，删除文件成功返回0，否则，返回错误代码
    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;
      }
    }
    ///
    /// 删除一组文件。
    ///
    ///字符串数组，表示一组文件名
    ///指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除
    ///指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框
    ///指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效
    ///反馈错误消息的字符串
    ///操作执行结果标识，删除文件成功返回0，否则，返回错误代码
    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) + "";   //组件文件组字符串
        }
        return ToDelete(fName, toRecycle, showDialog, showProgress, ref errorMsg);
      }
      catch (Exception ex)
      {
        errorMsg = ex.Message;
        return -200;
      }
    }
    #endregion 【删除文件操作】
    #region 【移动文件操作】
    ///
    /// 移动一个文件到指定路径下
    ///
    ///要移动的文件名
    ///移动到的目的路径
    ///指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框
    ///指示是否显示进度对话框
    ///指示当文件名重复时，是否自动为新文件加上后缀名
    ///反馈错误消息的字符串
    ///返回移动操作是否成功的标识，成功返回0，失败返回错误代码
    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;
      }
    }
    ///
    /// 移动一组文件到指定的路径下
    ///
    ///要移动的文件名数组
    ///移动到的目的路径
    ///指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框
    ///指示是否显示进度对话框
    ///指示当文件名重复时，是否自动为新文件加上后缀名
    ///反馈错误消息的字符串
    ///返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常
    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) + "";  //组件文件组字符串
        }
        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 【复制文件操作】
    ///
    /// 复制一个文件到指定的文件名或路径
    ///
    ///要复制的文件名
    ///复制到的目的文件名或路径
    ///指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框
    ///指示是否显示进度对话框
    ///指示当文件名重复时，是否自动为新文件加上后缀名
    ///返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常
    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;
      }
    }
    ///
    /// 复制一组文件到指定的路径
    ///
    ///要复制的文件名数组
    ///复制到的目的路径
    ///指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框
    ///指示是否显示进度对话框
    ///指示当文件名重复时，是否自动为新文件加上后缀名
    ///返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常
    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) + "";   //组件文件组字符串
        }
        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 【重命名文件】
    ///
    /// 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法
    ///
    ///要复制的文件名
    ///复制到的目的文件名或路径
    ///指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框
    ///返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常
    [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) + "";     //将文件名以结尾字符""结束
        lpFileOp.pTo = GetFullName(destinationFileName) + "";
        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;
      }
    }
    ///
    /// 利用Microsoft.VisualBasic.FileSystem.ReName()方法实现
    ///
    ///
    ///
    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 【重命名文件】
    ///
    /// 删除单个或多个文件
    ///
    ///删除的文件名，如果是多个文件，文件名之间以字符串结尾符''隔开
    ///指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除
    ///指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框
    ///指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效
    ///反馈错误消息的字符串
    ///操作执行结果标识，删除文件成功返回0，否则，返回错误代码
    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 + "";    //将文件名以结尾字符""结束
    &

相关文章

精彩推荐

一聚教程网

Copyright © 2010-2022

111cn.net All Rights Reserved