HOW TO：建立自訂選項頁面

發行項
08/12/2011

[選項] 對話方塊會顯示 Visual Studio 不同部分的各個選項頁。您可以依照控制選項設定中所描述的方式控制現有的選項頁，也可以建立自訂的選項頁。您可以使用自訂的選項頁，讓使用者變更增益集或其他程式的設定。

若要建立專屬自訂 [選項] 頁，您不必使用增益集，因為選項頁定義是儲存在 XML 檔中，而不是登錄機碼中。因此，您可以建立 [選項] 頁，而且在 Visual Studio 整合式開發環境 (IDE) 和巨集 IDE 中都可以存取。

下列步驟示範如何建立要當做自訂 [選項] 頁的自訂使用者控制項，然後再修改 .addin 檔來參考該選項頁。

注意事項
根據您目前使用的設定或版本，您所看到的對話方塊與功能表指令可能會與 [說明] 中描述的不同。使用 [一般開發設定] 開發了這些程序。如果要變更設定，請按一下 [工具] 功能表上的 [匯入和匯出設定]。如需詳細資訊，請參閱使用設定。

若要建立自訂選項頁

建立 Windows 控制項程式庫專案。將其命名為 ToolsOptionsLibrary.dll。
加入所需的控制項和功能，

這個使用者控制項即變成自訂的 [選項] 頁。調整控制項的大小，使其填滿 [選項] 對話方塊的工作區。

建置專案。

當 Visual Studio 啟動並載入現有的增益集時，會尋找所有共用的 .addin 檔。名為 [增益集/巨集安全性] 的 [選項] 頁會為 .addin 檔的檔案路徑定義一組語彙基元。其中包含下列語彙基元：

%ALLUSERSPROFILE%
%APPDATA%
%USERPROFILE%
%VSAPPDATA%
%VSCOMMONAPPDATA%

當 Visual Studio 開始搜尋 .addin 檔案時，會使用下列路徑字串取代這些語彙基元：

語彙基元	路徑
%ALLUSERSPROFILE%	.. \Documents and Settings\All Users\Application Data\Microsoft\MSEnvShared\Addins\
%APPDATA%	.. \Documents and Settings\<使用者名稱>\Microsoft\MSEnvShared\Addins\
%USERPROFILE%	.. \Documents and Settings\<使用者名稱>\My Documents\Visual Studio 2010\Addins\
%VSAPPDATA%	.. \Documents and Settings\<使用者名稱>\Addins\
%VSCOMMONAPPDATA%	.. \Documents and Settings\All Users\Addins

如需如何登錄增益集的詳細資訊，請參閱增益集安全性。

在前面列出的其中一個目錄內建立 .addin 檔，以參考新的 [選項] 頁。

您可以使用下列程式碼做為範本：

<?xml version="1.0" encoding="UTF-16" standalone="no"?>
<Extensibility xmlns="https://schemas.microsoft.com/AutomationExtensibility">
    <HostApplication>
        <Name>Microsoft Visual Studio Macros</Name>
        <Version>10.0</Version>
    </HostApplication>
    <HostApplication>
        <Name>Microsoft Visual Studio</Name>
        <Version>10.0</Version>
    </HostApplication>
    <ToolsOptionsPage>
        <Category Name="Environment">
            <SubCategory Name="My Tools Options Page">
                <Assembly><dll location></Assembly>
                <FullClassName>ToolsOptionsLibrary.UserControl1
                </FullClassName>
            </SubCategory>
        </Category>
    </ToolsOptionsPage>
</Extensibility>

在 <Assembly></Assembly> 標籤中，使用 ToolsOptionsLibrary.dll 的路徑取代 <dll location>。
變更 <ToolsOptionsPage> 設定 (Category Name、SubCategory Name 等) 以反映使用者控制項的自訂內容。

例如，如果使用者控制項命名為 "NewPage" 而其專案為 "MyTOLib"，則 FullClassName 標籤將會是 MyTOLib.NewPage。 Assembly 是選項 DLL 所在的位置。 Category Name 是您要在 [選項] 對話方塊中放置自訂選項頁的節點，例如 Environment、Debugging 或 Projects。

如果您指定不存在的名稱，就會建立這個名稱的節點。 SubCategory 是顯示在節點底下的名稱。請注意，最大的層級數是兩層。您無法加入第三層的節點。
在前述增益集檔案資料夾中，將檔案另存成副檔名為 .addin 的文字檔。預設的目錄為 .. \Documents and Settings\<使用者名稱>\Application Data\Microsoft\MSEnvShared\Addins\。

當 Visual Studio 啟動時，會在這個目錄中尋找自訂的 [選項] 頁定義，然後載入找到的定義。您可以在 [選項] 對話方塊中，使用 [Environment] 節點底下的 [增益集/巨集安全性] 頁來變更或加入增益集目錄。
啟動 Visual Studio，然後按一下 [工具] 功能表上的 [選項]。

新的 [選項] 頁隨即出現。

請參閱

共用方式為

HOW TO：建立自訂選項頁面

若要建立自訂選項頁

請參閱

工作

概念

其他資源

其他資源