C#中如何将Bitmap设置为文件图标？遇ArgumentException求解决

核心问题 #

1. Bitmap转Icon失败：Icon构造函数要求输入流必须是标准ICO格式，直接将Bitmap保存为PNG后转换会触发ArgumentException——因为PNG不是合法的ICO文件格式。
2. 不存在的SetFileIcon函数：Shell32.dll中没有SetFileIcon这个导出函数，原代码的该调用会导致后续的EntryPointNotFoundException。

正确实现思路 #

1. Bitmap转Icon的正确方式 #

通过GDI+的GetHicon获取Bitmap的句柄，再转换为Icon，并确保正确清理资源避免内存泄漏。

2. 为单个文件设置自定义图标（非文件类型关联） #

对于非可执行文件（如.txt），无法直接嵌入图标，需通过desktop.ini文件实现：

• 将目标文件标记为系统文件
• 创建desktop.ini配置文件指定图标路径
• 刷新Shell使更改生效

修正后的完整代码 #

using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Runtime.InteropServices;

class Program
{
    [DllImport("user32.dll", CharSet = CharSet.Auto)]
    private static extern bool DestroyIcon(IntPtr handle);

    [DllImport("Shell32.dll")]
    private static extern void SHChangeNotify(uint wEventId, uint uFlags, IntPtr dwItem1, IntPtr dwItem2);

    static void Main()
    {
        string filePath = @"C:\Path\To\Your\File.txt";
        string tempIconPath = @"C:\Temp\CustomTempIcon.ico"; // 临时保存ICO文件的路径

        // 1. 加载Bitmap并转换为Icon
        using (Bitmap customBitmap = new Bitmap("YourCustomIcon.bmp"))
        using (Icon customIcon = BitmapToIcon(customBitmap))
        {
            // 将Icon保存为ICO格式文件（供desktop.ini调用）
            using (FileStream fs = new FileStream(tempIconPath, FileMode.Create))
            {
                customIcon.Save(fs);
            }
        }

        // 2. 验证目标文件存在
        if (!File.Exists(filePath))
        {
            Console.WriteLine("文件不存在");
            return;
        }

        // 3. 配置desktop.ini实现自定义图标
        string folderPath = Path.GetDirectoryName(filePath);
        string desktopIniPath = Path.Combine(folderPath, "desktop.ini");

        // 将目标文件标记为系统属性（Shell才会读取desktop.ini配置）
        File.SetAttributes(filePath, File.GetAttributes(filePath) | FileAttributes.System);

        // 写入desktop.ini配置内容
        string iniContent = $@"[.ShellClassInfo]
IconResource={tempIconPath.Replace(@"\", @"\\")},0
IconFile={tempIconPath.Replace(@"\", @"\\")}
IconIndex=0
";
        File.WriteAllText(desktopIniPath, iniContent);

        // 将desktop.ini标记为隐藏+系统属性
        File.SetAttributes(desktopIniPath, FileAttributes.Hidden | FileAttributes.System);

        // 4. 刷新Shell使图标更改生效
        SHChangeNotify(0x08000000, 0x0000, IntPtr.Zero, IntPtr.Zero);

        Console.WriteLine("文件图标已成功设置！");
    }

    /// <summary>
    /// 将Bitmap转换为Icon，确保GDI资源正确清理
    /// </summary>
    private static Icon BitmapToIcon(Bitmap bitmap)
    {
        IntPtr hIcon = bitmap.GetHicon();
        try
        {
            Icon tempIcon = Icon.FromHandle(hIcon);
            // 克隆Icon避免原始句柄被意外释放
            Icon clonedIcon = (Icon)tempIcon.Clone();
            tempIcon.Dispose();
            return clonedIcon;
        }
        finally
        {
            // 销毁原始句柄，防止GDI资源泄漏
            DestroyIcon(hIcon);
        }
    }
}

关键说明 #

• Bitmap转Icon：通过GetHicon获取句柄，克隆Icon后销毁原始句柄，彻底避免GDI资源泄漏。
• desktop.ini配置：必须将目标文件和desktop.ini标记为系统属性，否则Shell会忽略该配置。
• Shell刷新：调用SHChangeNotify通知系统更新图标缓存，无需手动重启资源管理器。

替代方案（针对可执行文件） #

如果目标是EXE/DLL文件，可以通过修改PE文件的资源段嵌入图标，需使用UpdateResource等Win32 API实现，但操作复杂度较高，适合可执行文件的自定义图标需求。

内容的提问来源于stack exchange，提问作者tomato bar