RegisterEditorExtensionAttribute Klasa

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Shell

Zestaw:

Microsoft.VisualStudio.Shell.15.0.dll

Pakiet:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Przestroga

RegisterEditorExtensionAttribute has been deprecated. Please use ProvideEditorExtensionAttribute instead.

Zobacz: . Rejestruje rozszerzenie pliku w danej fabryce edytora. Klasa ta nie może być dziedziczona.

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

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

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
[System.Obsolete("RegisterEditorExtensionAttribute has been deprecated. Please use ProvideEditorExtensionAttribute instead.")]
public sealed class RegisterEditorExtensionAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
[<System.Obsolete("RegisterEditorExtensionAttribute has been deprecated. Please use ProvideEditorExtensionAttribute instead.")>]
type RegisterEditorExtensionAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class RegisterEditorExtensionAttribute
Inherits RegistrationAttribute

Dziedziczenie

Attribute

RegistrationAttribute

RegisterEditorExtensionAttribute

Atrybuty

AttributeUsageAttribute ObsoleteAttribute

Uwagi

Kiedy zadzwonić

Stosowanie atrybutu RegisterEditorExtensionAttribute do klas implementowania fabryki edytora

Podstawowe użycie

Ten atrybut kojarzy rozszerzenie pliku z daną fabryką edytora. Rozszerzenie pliku powinno zawierać prefiks ".".

Ten atrybut jest używany tylko do celów rejestracji i nie ma wpływu na zachowanie środowiska uruchomieniowego. Należy ją umieścić w klasie pakietu.

Każda fabryka edytorów ma również skojarzony priorytet. W przypadku danego rozszerzenia pliku edytory o najwyższym priorytcie mają szansę najpierw odczytać plik. Jeśli nie można odczytać pliku w edytorze, pozostałe edytory są używane w kolejności priorytetów. Aby użyć polecenia RegisterEditorExtensionAttribute, umieść go w klasie pakietu, takiej jak Package lub IVsPackage.

Wpisy rejestru

Następujący wpis rejestru jest tworzony przez program RegisterEditorExtensionAttribute:

<VSROOT>\Editors\{FactoryGuid}\Extensions\Extensions=Priority

Uwaga Identyfikatory GUID dla typów projektów Visual C# i Visual Basic to:

C#: {FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}

VB: {F184B08F-C81C-45F6-A57F-5ABD9991F28F}

Przykłady

Implementacje RegisterEditorExtensionAttribute funkcji można znaleźć w przykładach zarządzanych. Standardowa lokalizacja dla tego i wszystkich innych atrybutów używanych do automatycznej rejestracji jest sąsiadująca z implementacją Package w VsPkg.cs, VsPkg.vb lub VsPkg.cpp, w zależności od języka używanego w przykładzie.

Uwaga

Język C# automatycznie dołącza wyraz Atrybut do nazwy dowolnej klasy atrybutu. W kodzie języka C# należy odwołać się do tego atrybutu jako RegisterEditorExtension.

Konstruktory

RegisterEditorExtensionAttribute(Object, String, Int32)

Przestarzałe. Inicjuje nowy RegisterEditorExtensionAttribute dla dostarczonego typu fabryki i rozszerzenia.

Właściwości

EditorFactoryNotify	Przestarzałe. Pobiera lub ustawia, czy utworzyć klucz rejestru EditorFactoryNotify podczas rejestracji.
Extension	Przestarzałe. Pobiera rozszerzenie pliku.
Factory	Przestarzałe. Pobiera identyfikator GUID fabryki edytora.
NameResourceID	Przestarzałe. Pobiera lub ustawia identyfikator zasobu nazwy.
Priority	Przestarzałe. Pobiera priorytet rejestracji tego rozszerzenia.
ProjectGuid	Przestarzałe. Pobiera lub ustawia identyfikator GUID projektu.
TemplateDir	Przestarzałe. Pobiera lub ustawia katalog szablonu.
TypeId	Przestarzałe. Zastąp właściwość TypeID, aby umożliwić klasom pochodnym RegistrationAttribute pracować z atrybutem System.ComponentModel.TypeDescriptor.GetAttributes(...). Atrybut pochodzący z tego atrybutu będzie musiał zastąpić tę właściwość tylko wtedy, gdy potrzebuje lepszej kontroli nad wystąpieniami, które można zastosować do klasy. (Odziedziczone po RegistrationAttribute)

Metody

GetPackageRegKeyPath(Guid)	Przestarzałe. Pobiera ścieżkę rejestru (względem katalogu głównego rejestru aplikacji) pakietu VSPackage. (Odziedziczone po RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Przestarzałe. Rejestruje rozszerzenie edytora.
Unregister(RegistrationAttribute+RegistrationContext)	Przestarzałe. Usuwa klucz rejestru rozszerzenia edytora.