位置：文档库 > C#(.NET) > C# 创建快捷方式 / 取快捷方式目标

C# 创建快捷方式 / 取快捷方式目标

任豪上传于 2025-02-01 09:09

《C# 创建快捷方式 / 取快捷方式目标》

在Windows系统中，快捷方式（.lnk文件）是用户快速访问程序、文件或文件夹的重要工具。对于C#开发者而言，通过代码创建快捷方式或解析现有快捷方式的目标路径，是系统自动化、软件部署或工具开发中的常见需求。本文将详细介绍如何使用C#（基于.NET Framework和.NET Core）实现这两个功能，涵盖核心API调用、异常处理及跨平台兼容性考虑。

一、创建快捷方式

在Windows平台上，创建快捷方式需要调用Windows Shell API。.NET Framework提供了`IWshRuntimeLibrary`（Windows Script Host对象模型），而.NET Core/.NET 5+需通过P/Invoke或第三方库实现。

1.1 使用IWshRuntimeLibrary（.NET Framework）

步骤：

添加对`IWshRuntimeLibrary`的引用（通过COM组件“Windows Script Host Object Model”）
创建`WshShell`实例
调用`CreateShortcut`方法

using IWshRuntimeLibrary;

public static void CreateShortcut(string shortcutPath, string targetPath, 
                                string workingDir = "", string arguments = "", 
                                string iconPath = "")
{
    var shell = new WshShell();
    IWshShortcut shortcut = (IWshShortcut)shell.CreateShortcut(shortcutPath);
    
    shortcut.TargetPath = targetPath;
    shortcut.WorkingDirectory = workingDir;
    shortcut.Arguments = arguments;
    shortcut.IconLocation = iconPath; // 可选：设置图标
    shortcut.Save();
}

示例调用：

string desktopPath = Environment.GetFolderPath(Environment.SpecialFolder.Desktop);
string shortcutPath = Path.Combine(desktopPath, "Notepad.lnk");
CreateShortcut(shortcutPath, @"C:\Windows\notepad.exe", 
              workingDir: @"C:\", iconPath: @"C:\Windows\notepad.exe,0");

1.2 使用P/Invoke（跨平台方案）

对于.NET Core/.NET 5+，可通过`IShellLinkW`接口实现。需定义以下结构体和API：

[StructLayout(LayoutKind.Sequential)]
public struct SHELLLINKDATA
{
    public uint cbSize;
    public uint fFlags;
    public uint fAttr;
    public FILETIME creationTime;
    public FILETIME accessTime;
    public FILETIME writeTime;
    public uint fileSize;
    public int iconIndex;
    public char showCommand;
    public int hotKey;
    // 其他字段省略...
}

[ComImport]
[Guid("00021401-0000-0000-C000-000000000046")]
private class ShellLink { }

[DllImport("shell32.dll", SetLastError = true)]
private static extern int IPersistFile_Save(IntPtr psl, string pszFileName, int fRemember);

public static void CreateShortcutPInvoke(string shortcutPath, string targetPath)
{
    var shellLink = new ShellLink();
    IntPtr psl = Marshal.GetComInterfaceForObject(shellLink, typeof(IShellLinkW));
    
    // 设置目标路径（需调用IShellLinkW方法）
    // 实际实现需完整封装IShellLinkW接口，此处简化
    
    // 保存到文件
    IPersistFile_Save(psl, shortcutPath, 0);
    Marshal.Release(psl);
}

注：完整实现需封装`IShellLinkW`接口的所有方法，建议使用现成的NuGet包（如`NHotkey.Wpf`或`Microsoft.WindowsAPICodePack-Shell`）简化开发。

1.3 使用第三方库

推荐使用`Microsoft.WindowsAPICodePack-Shell`（NuGet安装）：

using Microsoft.WindowsAPICodePack.Shell;
using Microsoft.WindowsAPICodePack.Shell.PropertySystem;

public static void CreateShortcutWithAPIPack(string shortcutPath, string targetPath)
{
    ShellObject shellObj = ShellObject.FromParsingName(targetPath);
    var link = (IShellLinkW)new ShellLink();
    link.SetPath(targetPath);
    link.SetDescription("My Shortcut");
    ((IPersistFile)link).Save(shortcutPath, false);
}

二、解析快捷方式目标

解析.lnk文件的目标路径、工作目录等属性，同样可通过`IWshRuntimeLibrary`或P/Invoke实现。

2.1 使用IWshRuntimeLibrary

public static (string TargetPath, string WorkingDir, string Arguments) 
    GetShortcutInfo(string shortcutPath)
{
    var shell = new WshShell();
    IWshShortcut shortcut = (IWshShortcut)shell.CreateShortcut(shortcutPath);
    
    return (
        shortcut.TargetPath,
        shortcut.WorkingDirectory,
        shortcut.Arguments
    );
}

示例调用：

var info = GetShortcutInfo(@"C:\Users\Public\Desktop\Chrome.lnk");
Console.WriteLine($"Target: {info.TargetPath}");

2.2 使用P/Invoke（高级实现）

通过`IShellLinkW`接口读取属性：

[DllImport("shell32.dll", CharSet = CharSet.Unicode)]
private static extern int IShellLinkW_Resolve(IntPtr psl, IntPtr hwnd, uint fFlags);

public static string GetShortcutTargetPInvoke(string shortcutPath)
{
    var shellLink = new ShellLink();
    IntPtr psl = Marshal.GetComInterfaceForObject(shellLink, typeof(IShellLinkW));
    
    // 加载.lnk文件
    ((IPersistFile)shellLink).Load(shortcutPath, 0);
    
    // 获取目标路径
    IntPtr pathPtr = Marshal.AllocCoTaskMem(260 * 2);
    ((IShellLinkW)shellLink).GetPath(pathPtr, 260, out _, 0);
    string targetPath = Marshal.PtrToStringUni(pathPtr);
    
    Marshal.FreeCoTaskMem(pathPtr);
    Marshal.Release(psl);
    return targetPath;
}

2.3 异常处理与边界情况

处理无效路径、权限不足等问题：

try
{
    var info = GetShortcutInfo(@"C:\Nonexistent.lnk");
}
catch (FileNotFoundException ex)
{
    Console.WriteLine($"快捷方式不存在: {ex.Message}");
}
catch (COMException ex)
{
    Console.WriteLine($"COM错误: {ex.Message}");
}

三、跨平台兼容性考虑

.NET Core/.NET 5+默认不支持`IWshRuntimeLibrary`，需采取以下策略：

条件编译：区分.NET Framework和.NET Core
运行时检测：通过`Environment.OSVersion`判断平台
备用方案：在非Windows平台返回模拟数据或抛出`PlatformNotSupportedException`

public static void CreateShortcutSafe(string shortcutPath, string targetPath)
{
    if (Environment.OSVersion.Platform != PlatformID.Win32NT)
    {
        throw new PlatformNotSupportedException("仅支持Windows平台");
    }

#if NETFRAMEWORK
    CreateShortcut(shortcutPath, targetPath);
#else
    try
    {
        CreateShortcutWithAPIPack(shortcutPath, targetPath);
    }
    catch (DllNotFoundException)
    {
        throw new PlatformNotSupportedException("需要安装Windows API Code Pack");
    }
#endif
}

四、完整示例项目

以下是一个控制台应用程序示例，整合创建与解析功能：

using System;
using System.IO;
using IWshRuntimeLibrary; // 仅.NET Framework

class Program
{
    static void Main()
    {
        string desktop = Environment.GetFolderPath(Environment.SpecialFolder.Desktop);
        string shortcutPath = Path.Combine(desktop, "TestShortcut.lnk");
        string targetPath = @"C:\Windows\System32\calc.exe";

        // 创建快捷方式
        CreateShortcut(shortcutPath, targetPath);
        Console.WriteLine("快捷方式已创建");

        // 解析快捷方式
        var (target, dir, args) = GetShortcutInfo(shortcutPath);
        Console.WriteLine($"目标: {target}\n工作目录: {dir}\n参数: {args}");
    }

    static void CreateShortcut(string path, string target)
    {
        var shell = new WshShell();
        var shortcut = (IWshShortcut)shell.CreateShortcut(path);
        shortcut.TargetPath = target;
        shortcut.Save();
    }

    static (string TargetPath, string WorkingDir, string Arguments) 
        GetShortcutInfo(string path)
    {
        var shell = new WshShell();
        var shortcut = (IWshShortcut)shell.CreateShortcut(path);
        return (shortcut.TargetPath, shortcut.WorkingDirectory, shortcut.Arguments);
    }
}

五、性能优化建议

缓存`WshShell`实例，避免重复创建
使用`using`语句管理COM对象生命周期
异步调用API（如`Task.Run`）防止UI线程阻塞
对频繁操作的快捷方式进行内存缓存

六、常见问题解答

Q1：如何设置快捷方式的图标？
A：通过`IWshShortcut.IconLocation`属性，格式为`"路径,索引"`（如`C:\Windows\System32\shell32.dll,15`）。

Q2：.NET Core中如何替代`IWshRuntimeLibrary`？
A：使用`Microsoft.WindowsAPICodePack-Shell`或手动实现`IShellLinkW`接口。

Q3：如何检测快捷方式是否有效？
A：解析后尝试访问`TargetPath`，捕获`FileNotFoundException`。

Q4：跨平台时如何处理？
A：在非Windows平台抛出异常或返回空值，或使用条件编译隔离平台相关代码。

Q5：如何修改现有快捷方式？
A：与创建流程相同，重新设置属性后调用`Save()`方法。

关键词：C#快捷方式、.NET创建快捷方式、解析.lnk目标、IWshRuntimeLibrary、P/Invoke、跨平台兼容、Windows API Code Pack

简介：本文详细介绍C#中创建和解析Windows快捷方式的多种方法，涵盖.NET Framework的IWshRuntimeLibrary、.NET Core的P/Invoke实现及第三方库使用，包含完整代码示例、异常处理和跨平台策略，适合需要自动化快捷方式管理的开发者。

《C# 创建快捷方式 / 取快捷方式目标.doc》

将本文的Word文档下载到电脑，方便收藏和打印

推荐度：

点击下载文档

立即下载

C#(.NET)相关