HOW TO：建立增益集
更新：2007 年 11 月
增益集是編譯過的 DLL，可以在 Visual Studio 整合式開發環境 (IDE) 中執行。編譯的目的是要保護您的智慧財產並且改進效能。雖然您可以用手動方式建立增益集，但是使用 [增益集精靈] 要簡單許多。這個精靈會建立基本但實用的增益集，建立完成之後便可立即執行。增益集精靈產生基本的空程式之後，您可以新增程式碼並自訂架構。
若要了解進一步資訊 |
請參閱 |
|---|---|
Visual Studio 增益集與分享增益集之間的差異。 |
|
方案增益集 |
.gif)
.gif "注意事項") 注意事項： |
|---|
Visual Studio Express 版中不提供 [增益集精靈] 和 Automation 組件。 |
[增益集精靈] 可讓您提供增益集的顯示名稱和描述，這兩項資訊都會顯示在 [增益集管理員] 對話方塊中。您可以選擇由精靈產生程式碼，將開啟增益集的命令加入至 [工具] 功能表，也可以選擇顯示增益集的自訂 [關於] 對話方塊。當增益集完成時，您就會擁有一個新的專案，其中有一個名為 Connect 的類別會實作增益集。
| 注意事項： |
|---|
在 Visual Studio 2005 中建立的增益集不能用於 Visual Studio .NET 2003 中。在 Visual Studio .NET 2003 中建立的增益集如果未先經過移轉，可能無法在 Visual Studio 2005 中正常使用。如需詳細資訊，請參閱將增益集從 Visual Studio 2005 移轉和升級為 Visual Studio 2008。 |
若要在未建立增益集的情況下存取 Automation，您可以透過使用巨集來完成。巨集可以讓您快速而輕鬆地存取 Visual Studio 中的各種 Automation 模型。如需詳細資訊，請參閱 Visual Studio Automation 的範圍和使用巨集自動執行重複的動作。
您不需要使用增益集、精靈或巨集，就可以存取 Automation 功能。您可以改為在任何 Visual Studio 專案中將參考加入至所需的 Automation 組件，然後再存取其型別和成員的方法達成同樣的目的。但是，在巨集或增益集中使用 Automation，可讓您公開 (Expose) 您在 IDE 中建立的任何增益集工具。
在這個範例中，會示範如何建立方案增益集。
| 注意事項： |
|---|
根據目前使用的設定與版本，您所看到的對話方塊與功能表命令可能會與 [說明] 中所描述的不同。使用 [一般開發設定] 開發了這些程序。若要變更設定，請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊，請參閱 Visual Studio 設定。 |
若要使用增益集精靈建立增益集
建立新的 Visual Studio 增益集專案。在 [檔案] 功能表上，指向 [新增]，然後按一下 [專案]。巡覽至 [其他專案類型] 節點內的 [擴充性]。當您建立專案時，[增益集精靈] 便會啟動。
在 [選取程式語言] 頁上，選取您要用來撰寫增益集的程式語言。
在 [選擇主應用程式] 頁中，選擇一個或多個應用程式，例如 Visual Studio。
您可以在這裡選擇應用程式 (例如 Visual Studio 或 Visual Studio 的 [巨集 IDE])，此應用程式可讓您在建立增益集之後即可予以執行。
在 [輸入名稱和描述] 頁中，輸入增益集的名稱和描述。
注意事項：由於句號字元 (".") 在 Visual Studio 命令中具有特殊意義，因此如果您的增益集名稱中含有句號，Visual Studio 將無法建立預設的 [工具] 功能表命令。
建立增益集之後，其名稱和描述會顯示在 [增益集管理員] 對話方塊的 [可用的增益集 (Add-In)] 清單中。您可以為增益集加入詳細的描述資料，讓使用者了解增益集的功能、運作方式等。
在 [選擇增益集選項] 頁面中，您可以指定：
是否要將增益集顯示在 [工具] 功能表上。
何時要啟動增益集。
增益集是否要使用強制回應使用者介面 (Modal UI)。若不使用，便能安全地用於命令列組建 (Build)。
在 [ [關於] 對話方塊資訊選擇] 頁中，指定是否要將增益集的相關資訊顯示在 Visual Studio 說明的 [關於] 視窗中，如果要顯示的話，請加入您要顯示的資訊。
可以加入至 Visual Studio 說明 [關於] 視窗中的資訊包括：版本號碼、支援詳細資料、授權資料等。
完成步驟 1-6 之後，您選取的選項便會顯示在 [摘要] 頁面中供您檢閱。如果您對設定覺得滿意，請按一下 [完成] 建立增益集。如果您想要變更某些設定，請按一下 [上一頁] 按鈕。
您現在已擁有具有基本功能的增益集，若要啟用增益集執行某項工作，您必須再加入適當的程式碼。如需詳細資訊，請參閱擴充 Visual Studio 環境。
若要了解 [增益集精靈] 在幕後做了哪些事情，請檢查它所建立的程式碼。
安全性
Managed 增益集是以 .Addin 檔案登錄的增益集 (使用 XML 撰寫)。Visual Studio .NET 2002 和 Visual Studio .NET 2003 中的 [增益集精靈] 有一個核取方塊，可讓您為所有使用者登錄增益集。Visual Studio 2005 (含) 以後版本中的 [增益集精靈] 則沒有這個核取方塊。若要在 Visual Studio 2005 中為所有使用者登錄 Managed 增益集，請將 .Addin 檔案複製到 \Documents and Settings\All Users\ 資料夾中。若要在 Visual Studio 2005 中為所有使用者登錄 Unmanaged 增益集，請在 .reg 檔案內相關的登錄項目中，將 HKEY_CURRENT_USER 變更為 HKEY_CLASSES_ROOT，然後再將 .reg 檔套用至登錄中。如需詳細資訊，請參閱 在 Automation 中安全性的最佳作法 和 增益集安全性。