利用 .NET 開發 Excel Interop 應用程式：從內而外的增益集模式

using System;
using System.Collections.Generic;
using Excel = Microsoft.Office.Interop.Excel;

[assembly: System.ComponentModel.DescriptionAttribute(
    "OfficeStartupClass, Version=1.0, Class=TestOLE.MyClass")]

Class=TestOLE.MyClass 需對應專案的命名空間與類別名稱。

4. 在 MyClass 中實作 Excel 要求的兩個特定方法 _Startup 與 _Shutdown：

public Excel.Application MyApp;
public Excel.Workbook MyWorkBook;
public Excel.Worksheet MyWorksheet;

public void _Startup(object thisApp, object thisWorkbook)
{
    this.MyApp = thisApp as Excel.Application;
    this.MyWorkBook = thisWorkbook as Excel.Workbook;
    this.MyWorksheet = MyWorkBook.Worksheets[1] as Excel.Worksheet;
    MyWorksheet.Cells[1, 1] = "The add-on starts!";
}

public void _Shutdown()
{
    MyApp = null;
    MyWorkBook = null;
    MyWorksheet = null;
}

編譯專案即可產生 MyClass.dll。

三、安全性設定（.NET 1.x 原則）

雖然開發環境為 .NET 2.0/3.0，但產出的 DLL 安全性必須在 .NET 1.x 的原則下配置（如 caspol.exe 設定信任），詳細步驟請參考相關文件。

四、將增益集與 Excel 工作簿關聯

1. 開啟（或建立）一個 Excel 工作簿，選擇 檔案 → 內容 → 自訂 索引標籤。
2. 新增兩個自訂屬性：

• _AssemblyLocation0：DLL 所在完整路徑（例如 D:\Go4Pro Programs\00017\bin\Debug）。
• _AssemblyName0：組件名稱（不含副檔名，例如 TestOLE）。

儲存並重新開啟工作簿，若 A1 顯示 The add-on starts! 即代表增益集已成功載入並執行。

五、實作互動：透過超連結觸發 C# 方法

為了讓使用者能在工作簿中直接操控行為，我們利用 SheetFollowHyperlink 事件配合超連結來呼叫增益集方法。

1. 在 MyClass 中新增事件處理與業務邏輯：

private Excel.WorkbookEvents_SheetFollowHyperlinkEventHandler followHyperlinksEvent;

public void _Startup(object thisApp, object thisWorkbook)
{
    // ... 前略 ...
    followHyperlinksEvent = new Excel.WorkbookEvents_SheetFollowHyperlinkEventHandler(
        ThisWorkbook_SheetFollowHyperlink);
    MyWorkBook.SheetFollowHyperlink += followHyperlinksEvent;
}

protected void ThisWorkbook_SheetFollowHyperlink(System.Object s, Excel.Hyperlink l)
{
    switch (l.SubAddress)
    {
        case "ChangeTitle":
            ChangeTitle();
            break;
        default:
            break;
    }
}

public void ChangeTitle()
{
    MyApp.Caption = "Invoked from Excel (supported by C#)";
}

2. 在 Excel 工作簿中：

• 任意儲存格輸入文字（如 Click here to change the title!）。
• 將該儲存格命名為 ChangeTitle（須與 case 字串完全一致）。
• 選取該儲存格，插入超連結 → 本文件中的位置 → 定義的名稱 → 選擇 ChangeTitle。

儲存並重新開啟，點擊該儲存格即可看到 Excel 視窗標題被 C# 程式碼修改。

六、與傳統模式比較

孰優孰劣，端視專案需求與使用者技術能力而定。