ProvideEditorExtensionAttribute 类

定义

命名空间:

Microsoft.VisualStudio.Shell

程序集:

Microsoft.VisualStudio.Shell.15.0.dll

包:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

当应用于继承自 Package 或实现接口 IVsPackage的类时，将文件扩展名关联到给定编辑器工厂。

public ref class ProvideEditorExtensionAttribute sealed : Microsoft::VisualStudio::Shell::ProvideEditorAttributeBase

public ref class ProvideEditorExtensionAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideEditorExtensionAttribute : Microsoft.VisualStudio.Shell.ProvideEditorAttributeBase

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideEditorExtensionAttribute = class
    inherit ProvideEditorAttributeBase

Public NotInheritable Class ProvideEditorExtensionAttribute
Inherits ProvideEditorAttributeBase

继承

Attribute

RegistrationAttribute

ProvideEditorAttributeBase

ProvideEditorExtensionAttribute

属性

AttributeUsageAttribute

注解

此属性将文件扩展名与给定的编辑器工厂相关联。 文件扩展名应包含前缀“.”。 编辑器工厂可以指定为 GUID 或类型。

此属性还将优先级与编辑器工厂相关联。 对于给定的文件扩展名，优先级最高的编辑器有机会先读取文件。 如果编辑器无法读取文件，则按优先级顺序使用其余编辑器。 若要将给定编辑器设置为默认编辑器，请分配大于 0x60 的优先级。

此属性类仅用于为外部注册工具提供数据。 它不会影响运行时行为。

何时调用

将此文件扩展名属性应用于实现编辑器工厂的包类。 包类必须继承自 Package 或 IVsPackage。

注册表项

以下注册表项由此属性创建：

VSROOT\Editors\{FactoryGuid}\Extensions\Extension = Priority

注意

Visual C# 和 Visual Basic 项目类型的 GUID 分别为 {FAE04EC0-301F-11D3-BF4B-00C04F79EFBC} 和 {F184B08F-C81C-45F6-A57F-5ABD9991F28F}。

构造函数

ProvideEditorExtensionAttribute(Object, String, Int32)

初始化 ProvideEditorExtensionAttribute 的实例。

属性

DefaultName	获取或设置编辑器的默认名称。
EditorFactoryNotify	确定是否应向注册表值注册 EditorFactoryNotify 扩展，该值将文件扩展名与特定编辑器工厂相关联。
Extension	获取与此编辑器关联的文件扩展名。
Factory	编辑器工厂 guid。 (继承自 ProvideEditorAttributeBase)
NameResourceID	获取并设置整数 NameResourceID。
Priority	获取构造函数中设置的编辑器优先级。
ProjectGuid	设置并获取与此编辑器关联的项目的 GUID。
RegisterFactory	当应用于继承自 Package 或实现接口 IVsPackage的类时，将文件扩展名关联到给定编辑器工厂。
TemplateDir	获取或设置编辑器工厂用于检索其源文件的模板目录。
TypeId	重写 TypeID 属性，以便让 RegistrationAttribute 派生类与 System.ComponentModel.TypeDescriptor.GetAttributes 一起使用 (...) 。仅当派生自此属性的属性需要对可应用于类的实例使用更好的控件时，它才必须重写此属性。 (继承自 RegistrationAttribute)

方法

GetPackageRegKeyPath(Guid)	获取相对于 VSPackage 的应用程序) 注册表根目录 (注册表路径。 (继承自 RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	调用以便向给定的上下文注册此属性。 上下文包含应放置注册信息的位置。 它还包含要注册的类型和路径信息。
Unregister(RegistrationAttribute+RegistrationContext)	当外部注册工具（如 RegPkg.exe）调用时，删除有关 VSPackage 的注册信息。 有关详细信息，请参阅注册 VSPackage。