ProvideToolboxItemsAttribute 类

项目
10/25/2012

，如果它们。 Visual Studio 工具箱，提供安装项目中将此特性应用于实现 Vspackage 的类声明。

继承层次结构

System.Object
  System.Attribute
    Microsoft.VisualStudio.Shell.RegistrationAttribute
      Microsoft.VisualStudio.Shell.ProvideToolboxItemsAttribute

命名空间： Microsoft.VisualStudio.Shell
程序集： Microsoft.VisualStudio.Shell.11.0（在 Microsoft.VisualStudio.Shell.11.0.dll 中）

语法

声明
<AttributeUsageAttribute(AttributeTargets.Class, Inherited := True)> _
Public Class ProvideToolboxItemsAttribute _
    Inherits RegistrationAttribute

[AttributeUsageAttribute(AttributeTargets.Class, Inherited = true)]
public class ProvideToolboxItemsAttribute : RegistrationAttribute

ProvideToolboxItemsAttribute 类型公开以下成员。

构造函数

	名称	说明
	ProvideToolboxItemsAttribute(Int32)	创建一 ProvideToolboxItemsAttribute 的新实例实现 VSPackage 的类是否提供工具箱项目。
	ProvideToolboxItemsAttribute(Int32, Boolean)	初始化 ProvideToolboxItemsAttribute 新实例所指定的版本。

页首

属性

	名称	说明
	NeedsCallBackAfterReset	获取或设置是否应在每次工具箱重置后引发 ToolboxInitialized 事件。
	TypeId	获取此属性的当前实例。（继承自 RegistrationAttribute。）
	Version	返回的工具箱项目的版本 VSPackage 提供属性。

页首

方法

	名称	说明
	Equals	基础结构。返回一个值，该值指示此实例是否与指定的对象相等。（继承自 Attribute。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
	GetHashCode	返回此实例的哈希代码。（继承自 Attribute。）
	GetPackageRegKeyPath	获取注册表路径 (相对于应用程序的注册表根) VSPackage。（继承自 RegistrationAttribute。）
	GetType	获取当前实例的 Type。（继承自 Object。）
	IsDefaultAttribute	当在派生类中重写时，指示此实例的值是否是派生类的默认值。（继承自 Attribute。）
	Match	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。（继承自 Attribute。）
	MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
	Register	注册 VSPackage 为指定格式的一个工具箱项目提供程序，在调用由外部注册工具 (如 regpkg.exe。有关更多信息，请参见注册 Vspackage。（重写 RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext)。）
	ToString	返回表示当前对象的字符串。（继承自 Object。）
	Unregister	反转 Register 方法应用于注册表的更改。（重写 RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext)。）

页首

显式接口实现

	名称	说明
	_Attribute.GetIDsOfNames	将一组名称映射为对应的一组调度标识符。（继承自 Attribute。）
	_Attribute.GetTypeInfo	检索对象的类型信息，然后可以使用该信息获取接口的类型信息。（继承自 Attribute。）
	_Attribute.GetTypeInfoCount	检索对象提供的类型信息接口的数量（0 或 1）。（继承自 Attribute。）
	_Attribute.Invoke	提供对某一对象公开的属性和方法的访问。（继承自 Attribute。）

页首

备注

属性上下文

适用对象	提供 Vspackage 的类通过实现 IVsPackage， Package。
可重复	否
必需的特性	ProvideToolboxFormatAttribute
无效的特性	无

将此特性应用于 Package派生类或实现 IVsPackage 需要启用的类支持使用户可以由类拖动此格式，数据对象，假定，在 工具箱上。此实现的类必须处理放置通知。

此属性用于注册目的仅使用和不影响代码行为。

基于其构造函数指定的参数，则此属性可以指示 VSPackage 不提供任何 工具箱 项目。如果属性 ProvideToolboxFormatAttribute 添加到类中指示它提供 工具箱 项目，还必须添加 ProvideToolboxFormatAttribute 一个或多个实例。

此特性用于 ProvideToolboxFormatAttribute 注册 VSPackage，提供特定格式的 工具箱 项目。

如果此特性指定提供 工具箱 项目， VSPackage 必须处理 ToolboxInitialized 和 ToolboxUpgraded 事件。

使用此属性的所有 VSPackage 必须为 ToolboxInitialized 和 ToolboxUpgraded 事件提供处理程序。

示例

在下面的示例中，特性应用于类 MyPackage 指示它支持 工具箱 项目的 1 版与两个剪贴板格式 “CF_XMLCODE”和 “InPlaceMenuEditorMenu”。

    [DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]
    [ProvideToolboxItems(true, 1)]
    [ProvideToolboxFormat("CF_XMLCODE")]
    [ProvideToolboxFormat("InPlaceMenuEditorMenu")]
    [Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]
    internal sealed class MyPackage : Package

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared）成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.VisualStudio.Shell 命名空间

通过