ProvideEditorExtensionAttribute Klasse

Definition

Namespace:

Microsoft.VisualStudio.Shell

Assembly:

Microsoft.VisualStudio.Shell.15.0.dll

Paket:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Ordnet eine Dateierweiterung zu einer angegebenen Editorfactory zu, wenn Sie auf eine Klasse angewendet wird, die von Package erbt oder die IVsPackage Schnittstelle implementiert.

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

Vererbung

Attribute

RegistrationAttribute

ProvideEditorAttributeBase

ProvideEditorExtensionAttribute

Attribute

AttributeUsageAttribute

Hinweise

Dieses Attribut ordnet einer bestimmten Editorfactory eine Dateierweiterung zu. Die Dateierweiterung sollte das Präfix "." enthalten. Die Editorfactory kann entweder als GUID oder als Typ angegeben werden.

Dieses Attribut ordnet der Editorfactory auch eine Priorität zu. Für eine bestimmte Dateierweiterung erhält der Editor mit der höchsten Priorität die Möglichkeit, zuerst eine Datei zu lesen. Wenn der Editor die Datei nicht liest, werden die verbleibenden Editoren in der Reihenfolge der Priorität verwendet. Um einen bestimmten Editor zum Standardwert zu machen, weisen Sie eine Priorität zu, die größer als 0x60 ist.

Diese Attributklasse wird nur verwendet, um Daten für externe Registrierungstools bereitzustellen. Dies wirkt sich nicht auf das Laufzeitverhalten aus.

Wann sollte aufgerufen werden?

Wenden Sie dieses Dateierweiterungsattribut auf eine Paketklasse an, die eine Editorfactory implementiert. Die Paketklasse muss von oder IVsPackageerbenPackage.

Registrierungseinträge

Der folgende Registrierungseintrag wird mit diesem Attribut erstellt:

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

Hinweis

Die GUIDs für die Projekttypen Visual C# und Visual Basic sind {FAE04EC0-301F-11D3-BF4B-00C04F79EFBC} bzw. {F184B08F-C81C-45F6-A57F-5ABD9991F28F}.

Konstruktoren

ProvideEditorExtensionAttribute(Object, String, Int32)

Initialisiert eine instance von ProvideEditorExtensionAttribute.

Eigenschaften

DefaultName	Ruft den Standardnamen des Editors ab oder legt diesen fest.
EditorFactoryNotify	Bestimmt, ob die Erweiterung mit einem EditorFactoryNotify-Registrierungswert registriert werden soll, der eine Dateierweiterung einer bestimmten Editorfactory zuordnet.
Extension	Ruft die Dateierweiterung ab, die diesem Editor zugeordnet ist.
Factory	Die Guid der Editorfactory. (Geerbt von ProvideEditorAttributeBase)
NameResourceID	Ruft die ganze Zahl NameResourceID ab und legt sie fest.
Priority	Ruft die Priorität des Editors ab, so wie sie im Konstruktor festgelegt ist.
ProjectGuid	Legt fest und ruft die GUID des Projekts ab, das diesem Editor zugeordnet ist.
RegisterFactory	Ordnet eine Dateierweiterung zu einer angegebenen Editorfactory zu, wenn Sie auf eine Klasse angewendet wird, die von Package erbt oder die IVsPackage Schnittstelle implementiert.
TemplateDir	Ruft das Vorlagenverzeichnis ab oder legt dieses fest, welches von der Editor-Factory zu verwenden ist, um ihre Quelldateien abzurufen.
TypeId	Überschreiben Sie die TypeID-Eigenschaft, damit die abgeleiteten RegistrationAttribute-Klassen mit System.ComponentModel.TypeDescriptor.GetAttributes(...) arbeiten können. Ein von diesem abgeleitetes Attribut muss diese Eigenschaft nur überschreiben, wenn es eine bessere Steuerung für die Instanzen benötigt, die auf eine Klasse angewendet werden können. (Geerbt von RegistrationAttribute)

Methoden

GetPackageRegKeyPath(Guid)	Ruft den Registrierungspfad (relativ zum Registrierungsstamm der Anwendung) des VSPackages ab. (Geerbt von RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Wird aufgerufen, um dieses Attribut für den angegebenen Kontext zu registrieren. Der Kontext enthält die Position, an der die Registrierungsinformationen platziert werden sollen. Es enthält auch den Typ, der registriert wird, sowie Pfadinformationen.
Unregister(RegistrationAttribute+RegistrationContext)	Entfernt die Registrierungsinformationen zu einem VSPackage, wenn der Aufruf über ein externes Registrierungstool wie RegPkg.exe erfolgt. Weitere Informationen finden Sie unter Registrieren von VSPackages.