RegisterEditorExtensionAttribute Constructor (Object^, String^, Int32)

 

Initializes a new RegisterEditorExtensionAttribute for the supplied factory type and extension.

Namespace:   Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.14.0 (in Microsoft.VisualStudio.Shell.14.0.dll)

public:
RegisterEditorExtensionAttribute(
	Object^ factoryType,
	String^ extension,
	int priority
)

Parameters

factoryType
Type: System::Object^

One of following types:

The type of the editor factory expressed as a string.

The GUID of the editor factory.

The type of the editor factory.

extension
Type: System::String^

The file extension to associate with the editor factory. This extension should include the prefix ".".

priority
Type: System::Int32

The priority of this editor factory. Editors with higher priority numbers are given a chance to read a file first. Upon failure, the next editor in priority order is used.

Exception Condition
ArgumentNullException

This method throws an ArgumentNullException if:

  • Factory GUID value passed in factoryType is null.

  • extension is null.

ArgumentException

This method throws an ArgumentException if:

  • The factory GUID string cannot be converted to a GUID object.

  • Extension does not begin with a ".".

This constructor is useful if you do not have access to the editor factory because it is implemented elsewhere.

The following C# code applies the RegisterEditorExtension attribute to a VSPackage named BasicEditor.

using Microsoft.VisualStudio.Shell;
using MSVSIP = Microsoft.VisualStudio.Shell;
[MSVSIP.RegisterEditorExtension(typeof(EditorFactory), ".myext", 32, "{A2FE74E1-B743-11d0-AE1A-00A0C90FFFC3}", "..\\..\\Templates", 106)]
public class BasicEditor : MSVSIP.Package {}
Return to top
Show: