RegisterEditorExtensionAttribute, classe

Remarque : cette API est maintenant obsolète.

Consultez ProvideEditorExtensionAttribute.Enregistre une extension de fichier avec une fabrique donnée d'éditeur.Cette classe ne peut pas être héritée.

Hiérarchie d'héritage

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

Espace de noms :  Microsoft.VisualStudio.Shell
Assembly :  Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)

Syntaxe

'Déclaration
<ObsoleteAttribute("RegisterEditorExtensionAttribute has been deprecated. Please use ProvideEditorExtensionAttribute instead.")> _
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True, Inherited := True)> _
Public NotInheritable Class RegisterEditorExtensionAttribute _
    Inherits RegistrationAttribute
[ObsoleteAttribute("RegisterEditorExtensionAttribute has been deprecated. Please use ProvideEditorExtensionAttribute instead.")]
[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true, Inherited = true)]
public sealed class RegisterEditorExtensionAttribute : RegistrationAttribute

Le type RegisterEditorExtensionAttribute expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique RegisterEditorExtensionAttribute Initialise nouvel RegisterEditorExtensionAttribute pour le type et l'extension fournis de fabrique.

Début

Propriétés

  Nom Description
Propriété publique EditorFactoryNotify Obtient ou définit si créer la clé de Registre d'EditorFactoryNotify sur l'alignement.
Propriété publique Extension Obtient l'extension de fichier du fichier.
Propriété publique Factory Obtient la fabrique GUID d'éditeur.
Propriété publique NameResourceID Obtient ou définit l'ID de ressource en nom
Propriété publique Priority Obtient la priorité de cet alignement d'extension.
Propriété publique ProjectGuid Obtient ou définit le GUID du projet.
Propriété publique TemplateDir Obtient ou définit le répertoire de modèle.
Propriété publique TypeId Obtient l'instance actuel de cet attribut. (Hérité de RegistrationAttribute.)

Début

Méthodes

  Nom Description
Méthode publique Equals Infrastructure. Retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetHashCode Retourne le code de hachage de cette instance. (Hérité de Attribute.)
Méthode protégée GetPackageRegKeyPath Obtient le chemin d'accès au Registre (par rapport à la racine de Registre de l'application) du VSPackage. (Hérité de RegistrationAttribute.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique IsDefaultAttribute En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute.)
Méthode publique Match En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publique Register Enregistre l'extension d'éditeur. (Substitue RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext).)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publique Unregister Supprime la clé de Registre d'extension d'éditeur. (Substitue RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext).)

Début

Implémentations d'interface explicite

  Nom Description
Implémentation d'interface expliciteMéthode privée _Attribute.GetIDsOfNames Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée _Attribute.GetTypeInfo Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée _Attribute.GetTypeInfoCount Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute.)
Implémentation d'interface expliciteMéthode privée _Attribute.Invoke Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute.)

Début

Remarques

Lorsque appeler

Appliquez-vous l'attribut d'RegisterEditorExtensionAttribute aux classes implémentant une fabrique d'éditeur

Utilisation de base

Cet attribut associe une extension de fichier avec une fabrique donnée d'éditeur.L'extension de fichier doit comprendre le préfixant « . ».

Cet attribut est utilisé uniquement pour l'alignement et n'affecte pas le comportement d'exécution.Il doit être placé sur une classe de package.

Chaque fabrique d'éditeur a également une priorité associée.Pour une extension de fichier donnée, les éditeurs avec le numéro le plus élevée sont donnés l'occasion de lire un fichier en premier.Si l'éditeur ne lit pas le fichier, les éditeurs restants sont utilisés en ordre de priorité.Pour utiliser RegisterEditorExtensionAttribute, placez- sur une classe de package, telle qu'Package ou IVsPackage.

Entrées du Registre

L'entrée du Registre suivante est créée par RegisterEditorExtensionAttribute :

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

Remarque Le GUIDS pour les types de Visual c# et de projet Visual Basic sont :

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

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

Exemples

Vous pouvez rechercher des implémentations d'RegisterEditorExtensionAttribute dans les exemples managés.L'emplacement standard pour cela et toutes les autres l'attribue utilisé pour l'alignement automatique est en regard de l'implémentation d'Package dans VsPkg.cs, VsPkg.vb, ou VsPkg.cpp, selon le langage utilisé dans l'exemple.

[!REMARQUE]

Le C- ajoute automatiquement l'attribut de mot au nom de toute classe d'attributs.Dans le code C-, reportez -vous à cet attribut comme RegisterEditorExtension.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.VisualStudio.Shell, espace de noms

Autres ressources

Déterminer quel éditeur ouvrir un fichier dans un projet

Managed Package Registration

Stocker les VSPackages