C#调用Windows API实现方式彻底清空回收站实用指南

HRESULT SHEmptyRecycleBin(
  HWND   hwnd,
  LPCSTR pszRootPath,
  DWORD  dwFlags
);

using System;
using System.Runtime.InteropServices;

namespace RecycleBinUtility
{
    /// <summary>
    /// 清空回收站的操作标志
    /// </summary>
    [Flags]
    public enum RecycleBinFlags : uint
    {
        /// <summary>
        /// 不显示确认对话框
        /// </summary>
        SHERB_NOCONFIRMATION = 0x00000001,
        /// <summary>
        /// 不显示进度窗口
        /// </summary>
        SHERB_NOPROGRESSUI = 0x00000002,
        /// <summary>
        /// 操作完成后不播放声音
        /// </summary>
        SHERB_NOSOUND = 0x00000004
    }

    /// <summary>
    /// 提供清空回收站功能的静态类
    /// </summary>
    public static class RecycleBinHelper
    {
        // 导入 shell32.dll 中的 SHEmptyRecycleBin 函数
        [DllImport("shell32.dll", CharSet = CharSet.Auto)]
        private static extern int SHEmptyRecycleBin(IntPtr hwnd, string pszRootPath, RecycleBinFlags dwFlags);

        /// <summary>
        /// 清空回收站
        /// </summary>
        /// <param name="rootPath">要清空的回收站根路径（如“C:”）。为null或空字符串则清空所有驱动器。</param>
        /// <param name="flags">清空操作的标志组合。</param>
        /// <returns>操作是否成功。成功返回true，失败返回false。</returns>
        public static bool EmptyRecycleBin(string rootPath = null, RecycleBinFlags flags = RecycleBinFlags.SHERB_NOCONFIRMATION | RecycleBinFlags.SHERB_NOPROGRESSUI)
        {
            try
            {
                // 调用Windows API
                int result = SHEmptyRecycleBin(IntPtr.Zero, rootPath, flags);
                
                // 根据Windows API约定，返回值为0（S_OK）表示成功
                return result == 0;
            }
            catch (Exception ex)
            {
                // 在实际项目中，你可能需要记录这个异常
                // 例如：Log.Error($"清空回收站失败。路径：{rootPath}", ex);
                Console.WriteLine($"清空回收站时发生异常：{ex.Message}");
                return false;
            }
        }

        /// <summary>
        /// 清空所有驱动器上的回收站（静默方式，无确认无进度）
        /// </summary>
        public static bool EmptyAllRecycleBinsSilently()
        {
            return EmptyRecycleBin(null, RecycleBinFlags.SHERB_NOCONFIRMATION | RecycleBinFlags.SHERB_NOPROGRESSUI | RecycleBinFlags.SHERB_NOSOUND);
        }
    }
}

// 场景1：静默清空所有回收站（最常见）
private void btnEmptyAllSilently_Click(object sender, EventArgs e)
{
    bool success = RecycleBinHelper.EmptyAllRecycleBinsSilently();
    if (success)
    {
        MessageBox.Show("回收站已清空！");
    }
    else
    {
        MessageBox.Show("清空回收站失败，请检查系统权限或回收站状态。");
    }
}

// 场景2：清空特定驱动器（如D盘）的回收站，并显示进度条
private void btnEmptyDriveD_Click(object sender, EventArgs e)
{
    // 不传 SHERB_NOPROGRESSUI，就会显示进度窗口
    var flags = RecycleBinFlags.SHERB_NOCONFIRMATION; // 只有无确认标志
    bool success = RecycleBinHelper.EmptyRecycleBin("D:\", flags);
    // ... 处理结果
}

// 场景3：清空所有回收站，但需要用户确认
private void btnEmptyWithConfirm_Click(object sender, EventArgs e)
{
    // 不传 SHERB_NOCONFIRMATION，系统会弹出确认对话框
    // 传入当前窗体的句柄作为父窗口
    // 注意：这里需要修改EmptyRecycleBin方法，接受hwnd参数，为了示例清晰，暂不展开。
    // 一种简单做法是：flags = 0 (RecycleBinFlags)0
    var flags = (RecycleBinFlags)0; // 什么特殊标志都不加
    bool success = RecycleBinHelper.EmptyRecycleBin(null, flags);
    // 如果用户点了取消，API会返回错误码，success将为false。
}

private async void btnEmptyAsync_Click(object sender, EventArgs e)
{
    btnEmptyAsync.Enabled = false;
    this.Cursor = Cursors.WaitCursor;
    lblStatus.Text = “正在清空回收站...”；

    try
    {
        // 在后台线程执行清空操作
        bool success = await Task.Run(() => RecycleBinHelper.EmptyAllRecycleBinsSilently());

        if (success)
        {
            lblStatus.Text = “回收站已清空！”；
        }
        else
        {
            lblStatus.Text = “操作失败或已取消。”；
        }
    }
    catch (Exception ex)
    {
        lblStatus.Text = $“发生错误：{ex.Message}”；
    }
    finally
    {
        btnEmptyAsync.Enabled = true;
        this.Cursor = Cursors.Default;
    }
}

[StructLayout(LayoutKind.Sequential)]
public struct SHQUERYRBINFO
{
    public int cbSize; // 结构体大小
    public long i64Size; // 回收站总大小（字节）
    public long i64NumItems; // 回收站中项目总数
}

[DllImport("shell32.dll", CharSet = CharSet.Auto)]
private static extern int SHQueryRecycleBin(string pszRootPath, ref SHQUERYRBINFO pSHQueryRBInfo);

/// <summary>
/// 获取回收站信息
/// </summary>
/// <param name="rootPath">驱动器根路径，null表示所有驱动器</param>
/// <param name="totalSize">输出参数，回收站总大小（字节）</param>
/// <param name="itemCount">输出参数，回收站中项目总数</param>
/// <returns>是否成功</returns>
public static bool QueryRecycleBinInfo(string rootPath, out long totalSize, out long itemCount)
{
    totalSize = 0;
    itemCount = 0;
    SHQUERYRBINFO info = new SHQUERYRBINFO();
    info.cbSize = Marshal.SizeOf(info); // 关键！必须正确设置结构体大小

    int result = SHQueryRecycleBin(rootPath, ref info);
    if (result == 0)
    {
        totalSize = info.i64Size;
        itemCount = info.i64NumItems;
        return true;
    }
    return false;
}

[DllImport("kernel32.dll")]
private static extern uint GetLastError();

public static bool EmptyRecycleBinWithDetail(...)
{
    // ... 调用 SHEmptyRecycleBin
    if(result != 0)
    {
        uint errorCode = GetLastError();
        string errorMsg = new System.ComponentModel.Win32Exception((int)errorCode).Message;
        Console.WriteLine($“API调用失败，错误码：{errorCode}， 信息：{errorMsg}”);
        return false;
    }
    return true;
}

private static readonly object _recycleBinLock = new object();

public static bool EmptyRecycleBinThreadSafe(...)
{
    lock (_recycleBinLock)
    {
        return EmptyRecycleBin(...);
    }
}

using System;
using System.Windows.Forms;
using System.IO;
using System.Threading.Tasks;

namespace RecycleBinCleaner
{
    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();
            LoadDrives();
        }

        // 加载所有本地驱动器
        private void LoadDrives()
        {
            comboBoxDrives.Items.Clear();
            comboBoxDrives.Items.Add(“(所有驱动器)”);
            foreach (DriveInfo drive in DriveInfo.GetDrives())
            {
                if (drive.DriveType == DriveType.Fixed) // 只列出本地硬盘
                {
                    comboBoxDrives.Items.Add(drive.Name);
                }
            }
            if (comboBoxDrives.Items.Count > 0)
                comboBoxDrives.SelectedIndex = 0;
        }

        // 查询按钮点击事件
        private void btnQuery_Click(object sender, EventArgs e)
        {
            string selectedPath = comboBoxDrives.SelectedItem.ToString();
            string rootPath = (selectedPath == “(所有驱动器)”) ? null : selectedPath;

            if (RecycleBinHelper.QueryRecycleBinInfo(rootPath, out long totalSize, out long itemCount))
            {
                string sizeText = FormatFileSize(totalSize);
                lblStatus.Text = $“回收站状态：{itemCount} 个项目，共 {sizeText}”；
            }
            else
            {
                lblStatus.Text = “查询回收站信息失败。”；
            }
        }

        // 静默清空按钮点击事件（异步）
        private async void btnEmptySilently_Click(object sender, EventArgs e)
        {
            string selectedPath = comboBoxDrives.SelectedItem.ToString();
            string rootPath = (selectedPath == “(所有驱动器)”) ? null : selectedPath;

            btnEmptySilently.Enabled = false;
            lblStatus.Text = “正在清空...”；

            bool success = await Task.Run(() =>
                RecycleBinHelper.EmptyRecycleBin(rootPath,
                    RecycleBinFlags.SHERB_NOCONFIRMATION | RecycleBinFlags.SHERB_NOPROGRESSUI)
            );

            lblStatus.Text = success ? “清空完成！” ： “清空失败。”；
            btnEmptySilently.Enabled = true;

            // 清空后刷新状态
            if(success) btnQuery.PerformClick();
        }

        // 带确认的清空按钮点击事件
        private void btnEmptyWithConfirm_Click(object sender, EventArgs e)
        {
            string selectedPath = comboBoxDrives.SelectedItem.ToString();
            string rootPath = (selectedPath == “(所有驱动器)”) ? null : selectedPath;

            // 注意：这里flags为0，会弹出系统确认框。
            // 父窗口句柄传入this.Handle，让对话框模态化。
            bool success = RecycleBinHelper.EmptyRecycleBin(rootPath, (RecycleBinFlags)0);
            // 由于是模态对话框，代码会在此阻塞，直到用户操作完成。

            lblStatus.Text = success ? “已清空。” ： “用户取消或操作失败。”；
            if(success) btnQuery.PerformClick();
        }

        // 辅助方法：格式化文件大小
        private string FormatFileSize(long bytes)
        {
            string[] suffixes = { “B”, “KB”, “MB”, “GB”, “TB” };
            int counter = 0;
            double number = bytes;
            while (Math.Round(number / 1024) >= 1)
            {
                number = number / 1024;
                counter++;
            }
            return string.Format(“{0:n1} {1}”, number, suffixes[counter]);
        }
    }
}