共用方式為

正在註冊工具箱支援功能

  • 發行項

未受管理的 VSPackages 必須明確地更新登錄，以手動方式編輯它，或藉著使用登錄器 (.rgs) 檔案。 如需詳細資訊，請參閱 Creating Registrar Scripts。

自動的工具箱索引標籤上選取範圍

編輯器或設計工具中，所提供的編輯器工廠物件的執行個體可以要求特定工具箱索引標籤或作用中時建立他們本身就是使用中的類別。 比方說，如果表單設計工具就會啟動，您可能想所有 Windows Form 已選取索引標籤。

為自動工具箱類別選擇，才會生效，必須正確地登錄的設計工具或編輯器的工廠物件。

下列的登錄位置中找不到適當的登錄項目： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\ <Version> \Editor < 編輯器工廠 GUID >，其中 <Version> 已發行的 Visual Studio，例如 8.0 和 < 編輯器工廠 GUID > 的版本號碼 為編輯器工廠的 GUID。

項目應包含：

名稱

型別

Range

描述

Default

REG_SZ

GUID

選擇項。 它可以用來包含編輯器] 中的非當地語系化名稱。

DefaultToolboxTab

REG_SZ

 "您的索引標籤名稱"

這個編輯器使用中時，由預設工具箱索引標籤上 [工具箱] 索引標籤的非當地語系化名稱。
注意事項注意事項

有沒有Attribute支援這些登錄項目管理套件架構中的物件。

登錄封裝提供工具箱項目

注意事項注意事項

Visual Studio 10 SDK 中的工具箱控制項範本所建立的控制項自動註冊。如需詳細資訊，請參閱 How to： 建立使用 Windows Form 的工具箱控制項和 How to： 建立使用 WPF 的工具箱控制項。

任何 VSPackage 提供ToolboxItem物件必須有子機碼， 工具箱，在它自己的封裝機碼，HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\Packages\< 封裝 GUID>，其中 <Version> 是 8.0 時，例如 Visual Studio，發行的版本號碼和 < 封裝 GUID > 是 GUID，封裝所提供的工具箱項目。

這個工具箱子機碼必須包含至少一個項目時，名為 DWORD 項目預設項目。

注意事項注意事項

根路徑的 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> 可覆寫其他的根時初始化 Visual Studio 殼層時，或者您也可以使用DefaultRegistryRootAttribute。如需詳細資訊，請參閱 命令列參數 (Visual Studio SDK)。

在 [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\] 下的項目<Version>\Packages\< 封裝 GUID>：

名稱

型別

資料

描述

預設的項目

REG_DWORD

可以是任何 DWORD 值。 從 1 開始。 如果您要更新您的 VSPackage，以提供更多或不同的項目，就會增加此值。

值為預設項目必須是大於或等於 1，將ToolboxItem物件到Visual Studio工具箱。 

變更的值預設項目將會造成Visual Studio IDE 載入最新的執行個體的 VSPackage，提供ToolboxItem物件，而不使用任何快取的值。

在管理套件架構中， 預設項目的設定方式的建構函式中使用的值是ProvideToolboxItemsAttribute執行個體套用至 VSPackage 提供ToolboxItem物件。

註冊以非標準格式的支援

支援剪貼簿] 的登錄設定的格式， ToolboxItem VSPackage 支援的提供者是選擇性的。

如果ToolboxItem VSPackage 的提供者不會登錄任何特殊的剪貼簿格式，則它必須支援Visual Studio標準格式。 如需有關標準工具箱剪貼簿格式，請參閱工具箱 (Visual Studio SDK)。

如果 VSPackage 確實支援非標準的格式，它必須註冊這些格式下 VSPackage 的工具箱 登錄機碼 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\Packages\< 封裝 GUID> \Toolbox，加上一個字串項目，名為 格式。

注意事項注意事項

VSPackage 通氣機支援的任何自訂的格式、 它是否只支援明確註冊這些格式。註冊自訂的剪貼簿格式的 VSPackage 不會再登錄為支援預設的工具箱剪貼簿格式，除非它是明確。

名稱

型別

資料

描述

格式

REG_SZ

對於自訂的格式，用於這個子機碼中的字串。

指定支援的 VSPackage，提供自訂的剪貼簿格式工具箱的剪貼簿格式 (藉由實作IVsToolboxDataProvider和IVsToolboxDataProvider2)。

格式應該指定逗號分隔的清單中。

您可以指定一種格式以包含它的名稱或它的識別碼名稱的字串。 例如， Formats項目可能是'1,13,16,HTML Format'。

如需有關剪貼簿格式的詳細資訊，請參閱Format。

在管理套件架構中，值格式取自的字串做為引數的建構函式的執行個體， ProvideToolboxFormatAttribute物件套用到 VSPackage 提供ToolboxItem物件。

註冊動態的工具箱項目組態的支援

如果 VSPackage 提供實作的IConfigureToolboxItem它必須新增登錄設定，在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID。 與 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration。

在 [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\] 下的登錄資料<Version>\CLSID 地Visual Studio的環境需要叫用的實作IConfigureToolboxItem。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration 資料用來選取或篩選的ToolboxItem物件的實作IConfigureToolboxItem為基礎的組件包含這些原則設定。

內容的 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID 登錄項目：

注意事項注意事項

在 [管理套件架構中，這些登錄項目所建立的執行個體ProvideToolboxItemConfigurationAttribute。這個執行個體已附加到提供的 VSPackage ToolboxItem使用反映的組態。反映對IConfigureToolboxItem項目提供給ProvideToolboxItemConfigurationAttribute建構函式。

名稱

型別

資料

描述

(預設值)

REG_SZ

(選擇性)

類別實作的完整名稱IConfigureToolboxItem。

的值應該與所提供的相同FullName作用於Type實作IConfigureToolboxItem。

Assembly

REG_SZ

完整的組件提供的名稱IConfigureToolboxItem

這個值必須是完整的組件識別，這取決於組件，可能包括：

  • 簡單名稱

  • 版本號碼

  • 密碼編譯金鑰組

  • 支援的文化特性

  • 自訂欄位

值必須是屬性值的逗號分隔清單，因為會由FullName屬性作用於Type實作IConfigureToolboxItem。

例如：

MyPackage.Toolbox, Version=8.0.1200.0, Culture=neutral,PublicKeyToken=abcdef12345ab, Custom=null

不支援萬用字元。

在格式完整的組件名稱的相關資訊，請參閱AssemblyQualifiedName。

IConfigureToolboxItem.

如需有關組件識別的詳細資訊，請參閱AssemblyName。

類別

REG_SZ

類別實作的完整名稱IConfigureToolboxItem所提供的介面FullName。

值應該與所提供的相同FullName、 型別實作 acting IConfigureToolboxItem。

程式碼基底

REG_SZ

提供的實作的組件位置IConfigureToolboxItem

這個值必須是包含實作的組件檔案的完整的路徑IConfigureToolboxItem。

InprocServer32

REG_SZ

一定要先設定"C:\WINDOWS\System32\mscoree.dll"

同處理序伺服器

ThreadingModel

REG_SZ

一定要先設定"Both"

執行緒模型

內容的 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration 登錄項目：

注意事項注意事項

在 [管理套件架構中，這些登錄項目所建立的執行個體ProvideAssemblyFilterAttribute附加至Type提供的實作IConfigureToolboxItem。

名稱

型別

資料

描述

<AssemblyName>

REG_SZ

若要選取或篩選的組件規格。

機碼的名稱， <AssemblyName>，必須指定完整的組件識別，其中可能包括根據來作為篩選條件的組件的格式：

  • 簡單名稱

  • 版本號碼

  • 密碼編譯金鑰組

  • 支援的文化特性

  • 自訂欄位

機碼的名稱必須是逗點分隔的屬性值組清單。 在格式完整的組件名稱的相關資訊，請參閱Type.FullName屬性。

萬用字元的"*"都支援此值，並不提供任何欄位會被視為萬用字元。

舉個例說，索引鍵的名稱

System.Windows.*, Version=8.0.*, Culture=*,PublicKeyToken=*

選取所有的組件與命名空間，在System.Windows (雖然不System.Windows本身)、 8.0 的版本中，所有次要版本和文化特性、 密碼編譯金鑰的值和自訂的字串。

在管理套件架構中， < 組件名稱 > 機碼的名稱由字串當做引數的建構函式使用ProvideAssemblyFilterAttribute執行個體套用至類別實作IConfigureToolboxItem介面。

<ImplementationObject>

REG_SZ

GUID

這個子機碼名稱 AssemblyName 是完整限定的名稱Type實作IConfigureToolboxItem介面。

這個子機碼的值是這個 GUID Type。

在管理套件架構中這項資訊可透過反映類別實作取得IConfigureToolboxItem與ProvideAssemblyFilterAttribute物件套用到它。

在 [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\] 下的項目的範例<Version>\ToolboxItemConfiguration 就是：

        Vsip.*, Version=2.0.3500

            Vsip.ToolboxConfiguration = {YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY}

請參閱

參考

ProvideToolboxItemsAttribute

ProvideToolboxFormatAttribute

ProvideAssemblyFilterAttribute

IConfigureToolboxItem

ToolboxItem

概念

管理工具箱

How to： 使用 Interop 組件提供自訂工具箱項目