SharpShell 开源项目安装与使用指南

目录结构及介绍

SharpShell 是一个.NET 框架库，用于在C#中开发Windows Shell扩展（如上下文菜单项、属性页等）。下面将详细介绍项目的主要目录及其功能：

├── SharpShell
│   ├── SharpMenu     # 提供自定义上下文菜单的功能。
│   ├── SharpPropertySheet # 提供自定义属性页的功能。
│   └── ...
├── Tests
│   ├── TestSharpMenu # 测试SharpMenu中的功能。
│   ├── TestSharpPropertySheet # 测试SharpPropertySheet中的功能。
│   └── ...
├── Examples
│   ├── ExampleSharpMenu # 实现一个示例上下文菜单的代码。
│   ├── ExampleSharpPropertySheet # 实现一个示例属性页的代码。
│   └── ...
└── SharpShell.sln # Visual Studio解决方案文件，用于打开整个项目。

其中，SharpShell目录包含了核心的SharpShell组件，提供了一系列类和接口以方便开发者集成到自己的项目中。

启动文件介绍

由于SharpShell本身是一个库，并不直接作为应用程序运行，因此它没有传统意义上的“启动”过程或特定的“启动”文件。不过，在Examples目录下提供了多个示例工程，这些工程展示了如何利用SharpShell来创建具体的应用实例。每个示例工程通常包含以下类型的关键文件：

• Program.cs 或其他主入口点文件：这是应用程序的起点，用于初始化并运行你的Shell扩展。

例如，在ExampleSharpMenu目录下的Program.cs可能看起来像这样：

using SharpShell;
using System.Windows.Forms;

public static class Program
{
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        new ShellExtension().Register();
    }
}

这个文件的作用是初始化Windows Forms环境，并调用注册方法将Shell扩展注册到系统中，使其能够在正确的情况下显示出来。

配置文件介绍

SharpShell自身并不依赖任何外部配置文件，所有的配置和参数都是通过代码进行设置的。然而，在某些情况下，你可能会想要添加一些配置选项，比如控制Shell扩展的行为、外观或者与其他系统服务的交互方式。

当创建定制化的Shell扩展时，你可以选择性地引入配置机制，常见的做法是在项目中加入.config文件，利用.NET Framework自身的配置管理功能。例如，你可以在App.config或Web.config中存储Shell扩展所需的选项：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <add key="MyShellExtension_Key" value="Value"/>
    </appSettings>
</configuration>

然后在代码中读取这些配置值，以便动态调整Shell扩展的行为：

var config = ConfigurationManager.AppSettings["MyShellExtension_Key"];
if (!string.IsNullOrEmpty(config))
{
    // 根据配置值调整行为...
}

需要注意的是，上述配置只是示范性的，并非SharpShell框架本身的必要组成部分。具体的配置需求应当根据实际的Shell扩展设计而定。